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}

Gets search company session by ID, 

Response Parameters

StatusCreated, Finished, Failed, Timeout 
stockNameShareholder stock name
formerNamesFormer company names
contactInfophoneNumber,webSites ,email
legalPersonNameLegal representative
revokeReasonReason of revoke
regAddressRegistration address
regAuthorityRegistration authority
StatusOrderCreated, OrderProcessed, OrderTimeout, OrderCompleted, CallbackSucceeded, CallbackFailed, CallbackTimeout, OrderNotFound
CodeRequestSucceeded, RequestFailed, AccountHasNoAccessToApi, InvalidAccount, InsufficientBalance, InsufficientNumberOfRequests, InsufficientPeriodOfValidity, MissingRequiredParameter, IncorrectAccountInformation, IpRestricted, ExceededRequestLimit, AuthorizationFailed, IncorrectParameterInformation, SystemError
Idstring($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": []
}