LookUpCompanyBasic
Lookup Asian company by its unique identifier. UNIQUE IDENTIFIER for China company lookup is
1) Full Chinese name,
2) Registration Number, or
3) Unified Social Credit Code.
API Calls
Start looking up for a company:
POST https://env
.zignsec.com/api/v5/ekyb/companies/lookup/basic
Get Session Result:
GET https://env
.zignsec.com/api/v5/ekyb/companies/lookup/basic/{sessionId}
where env
is api or test and sessionid
is the session identifier retrieved from the setup call, named id in the response.
API documentation
1. Start Session
Lookup company query. Either name or identifier must be present. Identifier takes precedence if both set.
POST to https://test-gateway.zignsec.com/api/v5/ekyb/companies/lookup/basic Content-Type: application/json; charset=UTF-8 Authorization: YOUR ACCESS TOKEN Host: https://test-gateway.zignsec.com/
Request parameters
Name | Company name (local language, Full Chinese name for China) | Not Required |
Number | Registration Number, or Unified Social Credit Code. | Not Required |
CountryCode | (Default China) [CHN] | Not required |
LanguageCode | Asia verify supported language [EN – English, OG – Original language] |
Request Body example
{ "providerRequest": { "name": "Alibaba", "number": "330100400015575", "countryCode": "CHN", "languageCode": "EN", "environment": "Test" }, "sessionContext": {} }
2. Get Session Result
GET https://env
.zignsec.com/api/v5/ekyb/companies/lookup/basic/{sessionId}
Response Parameters
Status | Created, Finished, Failed, Timeout | ||
stockName | Shareholder stock name | ||
formerNames | Former company names | ||
contactInfo | phoneNumber,webSites ,email | ||
legalPersonName | Legal representative | ||
revokeReason | Reason of revoke | ||
regAddress | Registration address | ||
regAuthority | Registration authority | ||
Status | OrderCreated, OrderProcessed, OrderTimeout, OrderCompleted, CallbackSucceeded, CallbackFailed, CallbackTimeout, OrderNotFound | ||
Code | RequestSucceeded, RequestFailed, AccountHasNoAccessToApi, InvalidAccount, InsufficientBalance, InsufficientNumberOfRequests, InsufficientPeriodOfValidity, MissingRequiredParameter, IncorrectAccountInformation, IpRestricted, ExceededRequestLimit, AuthorizationFailed, IncorrectParameterInformation, SystemError | ||
Id | string($uuid) | ||
Errors | List of errors |
Response Body example
{ "status": "Finished", "result": { "result": { "data": { "shareholders": { "numberOfItems": 3, "items": [ { "capitalSubscribed": { "value": [ "2594740000.00USD" ], "providerRawString": "2594740000.00USD" }, "capitalSubscriptionDates": { "value": [ "2040-09-08T00:00:00" ], "providerRawString": "2040-09-08 00:00:00" }, "stockName": "Taobao (China) Software Co., Ltd.", "capitalPaid": { "value": [], "providerRawString": "" }, "stockPercent": "50.6555%", "capitalPaymentDates": { "value": [], "providerRawString": "" } }, { "capitalSubscribed": { "value": [ "1813470000.00USD" ], "providerRawString": "1813470000.00USD" }, "capitalSubscriptionDates": { "value": [ "2040-09-08T00:00:00" ], "providerRawString": "2040-09-08 00:00:00" }, "stockName": "Zhejiang Tmall Technology Co., Ltd.", "capitalPaid": { "value": [], "providerRawString": "" }, "stockPercent": "35.4032%", "capitalPaymentDates": { "value": [], "providerRawString": "" } }, { "capitalSubscribed": { "value": [ "714120000.00USD" ], "providerRawString": "714120000.00USD" }, "capitalSubscriptionDates": { "value": [ "2040-09-08T00:00:00" ], "providerRawString": "2040-09-08 00:00:00" }, "stockName": "Alibaba.com China Limited", "capitalPaid": { "value": [ "1000000.00USD", "5000000.00USD", "8000000.00USD", "95000000.00USD", "40000000.00USD", "50000000.00USD", "15000000.00USD", "15000000.00USD", "990000.00USD", "40000000.00USD" ], "providerRawString": "1000000.00USD,5000000.00USD,8000000.00USD,95000000.00USD,40000000.00USD,50000000.00USD,15000000.00USD,15000000.00USD,990000.00USD,40000000.00USD" }, "stockPercent": "13.9413%", "capitalPaymentDates": { "value": [ "1999-11-03T00:00:00", "2003-06-23T00:00:00", "2004-10-15T00:00:00", "2007-12-21T00:00:00", "2010-12-02T00:00:00", "2011-11-04T00:00:00", "2011-12-26T00:00:00", "2012-06-26T00:00:00", "2012-12-18T00:00:00", "2013-06-27T00:00:00" ], "providerRawString": "1999-11-03 00:00:00, 2003-06-23 00:00:00, 2004-10-15 00:00:00, 2007-12-21 00:00:00, 2010-12-02 00 :00:00,2011-11-04 00:00:00,2011-12-26 00:00:00,2012-06-26 00:00:00,2012-12-18 00:00:00,2013 -06-27 00:00:00" } } ] }, "majorPersons": { "numberOfItems": 4, "items": [ { "name": "Dai Shan", "positions": "Chairman and General Manager" }, { "name": "Zhang Yu", "positions": "Director" }, { "name": "Jiang Fang", "positions": "Director" }, { "name": "Feng Yunle", "positions": "Supervisor" } ] }, "companyRegistrations": { "numberOfItems": 1, "items": [ { "formerNames": [ { "historyName": "Alibaba (Hangzhou) Network Technology Development Co., Ltd." }, { "historyName": "Alibaba (China) Network Co., Ltd." } ], "contactInfo": { "phoneNumber": "0571-85022088", "webSites": [ { "url": "https://www.alibabagroup.com/cn/global/home" } ], "email": "[email protected]" }, "legalPersonName": "Dai Shan", "approvedDate": { "value": "2020-03-26T00:00:00", "providerRawString": "2020-03-26 00:00:00" }, "businessStartDate": { "value": "1999-09-09T00:00:00", "providerRawString": "1999-09-09 00:00:00" }, "businessEndDate": { "value": "2040-09-08T00:00:00", "providerRawString": "2040-09-08 00:00:00" }, "revokeDate": { "providerRawString": "" }, "revokeReason": "", "numberOfEmployees": "4000-4999 people", "regAddress": "699 Wangshang Road, Binjiang District, Hangzhou City, Zhejiang Province", "regAuthority": "Hangzhou High-tech Zone (Binjiang) Market Supervision Administration", "orgType": "Limited liability company (Taiwan, Hong Kong or Macau and domestic joint venture)", "orgCode": "71610585-2", "businessScope": "Develop and sell computer network application software; design, produce, and process computer network products and provide related technical services and consulting services; services: own property leasing, translation, adult non-certified labor vocational skills training (except for licenses) . (Projects that are subject to approval in accordance with the law can only carry out business activities after approval by relevant departments)", "regNumber": "330100400015575", "creditCode": "91330100716105852F", "regCapital": "10725260000.00USD", "companyName": "阿里巴巴(中国)网络技术有限公司", "companyNameEnglish": "Alibaba(China)Network Technology Co., Ltd.", "companyStatus": "Existing", "establishDate": "1999-09-09 00:00:00" } ] } }, "lastUpdated": "2021-05-17T13:39:59", "orderId": "av202104271731200813073546", "total": 1, "status": "OrderCompleted" }, "code": "RequestSucceeded", "message": "Request succeeded" }, "id": "b7de7401-8512-4094-9614-264c8381e4fa", "errors": [] }