The `LookupCompanyAdvanced V5` API provides detailed company information from business registers using advanced search parameters. It is designed for thorough due diligence, compliance checks, and business verification processes.
---
#### **API Endpoint**
**POST** /core/api/sessions/asia-verify/companies/lookup/advanced
**Base URL**:
`https://test-gateway.zignsec.com`
---
#### **Request Format**
**Headers**:
- `Content-Type`: `application/json`
- `Authorization`: `Your Subscription Key`
- `Accept`: `application/json`
**Request Body**:
```json
{
"gdpr_user_id": "string",
"metadata":
{
"country_code": "CHN",
"language": "EN",
"name": "小米科技有限责任公司",
"number": "91110108551385082Q"
},
"relay_state": "string",
"webhook": "string"
}
```
**Parameters**:
|Parameter|Type|Required|Description|
|---|---|---|---|
|`gdpr_user_id`|string|No|GDPR-compliant user identifier. Optional for user tracking purposes.|
|`metadata`|object|Yes|Contains detailed information about the company being queried.|
|`country_code`|string|Yes|ISO country code where the company is registered. Example: CHN for China.|
|`language`|string|Yes|The language for the response. Example: EN for English.|
|`name`|string|Yes|The official name of the company being queried.|
|`number`|string|Yes|The registration number of the company.|
|`relay_state`|string|No|Optional parameter for managing the application state during the request.|
|`webhook`|string|No|URL to which the results will be sent upon completion.|
---
#### **Response Format**
**Success Response**:
```json
{
"status": "Success",
"data":
{
"companyName": "小米科技有限责任公司",
"registrationNumber": "91110108551385082Q",
"status": "Active",
"address":
{
"street": "No. 1 Xiaomi Street",
"postalCode": "100000",
"city": "Beijing",
"country": "CHN"
},
"dateOfIncorporation": "2010-03-03",
"businessNature": "Technology",
"directors": [
{
"name": "Lei Jun",
"role": "CEO",
"appointedDate": "2010-03-03"
}
],
"shareholders": [
{
"name": "Xiaomi Inc.",
"percentageOwnership": 100
}
]
}
}
```
**Response Fields**:
|Field|Type|Description|
|---|---|---|
|`companyName`|string|The official name of the company.|
|`registrationNumber`|string|The unique registration number of the company.|
|`status`|string|Operational status of the company (e.g., Active, Inactive).|
|`address`|object|The company's registered address.|
|`dateOfIncorporation`|string|The company's incorporation date in YYYY-MM-DD format.|
|`businessNature`|string|The nature of the company's business.|
|`directors`|array|List of directors with their roles and appointment dates.|
|`shareholders`|array|List of shareholders and their percentage of ownership.|
---
#### **Error Responses**
|HTTP Code|Error Message|Description|
|---|---|---|
|`400`|`Invalid Request`|Input parameters are missing or invalid.|
|`401`|`Unauthorized`|Missing or invalid subscription key.|
|`404`|`Company Not Found`|No company matches the provided identifier or name.|
|`500`|`Internal Server Error`|An unexpected error occurred on the server.|
---
#### **Notes**
- The `webhook` parameter allows asynchronous handling of results, which will be sent to the specified URL once available.
- Use `relay_state` to maintain context about the application or user session during processing.