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.