#### **Overview**
The `Lookup Company Basic` API retrieves essential company information from the business registry based on the provided identifiers. This service supports use cases such as company verification, onboarding, and compliance.
1) Full Chinese name
2) Registration Number
3) Unified Social Credit Code
#### **API Endpoint**
`POST /Asia-verify/Companies/LookupBasic`
**Base URL**:
`https://test-gateway.zignsec.com`
---
#### **Request Format**
**Headers**:
- `Content-Type`: `application/json`
- `Authorization`: `<subscription_key>`
**Request Body**:
```json
{
"countryCode": "SG",
"companyIdentifier": "201123456H",
"name": "Example Pte Ltd"
}
```
**Parameters**:
|Parameter|Type|Required|Description|
|---|---|---|---|
|`countryCode`|string|Yes|ISO country code where the company is registered. Example: SG for Singapore.|
|`companyIdentifier`|string|Yes|The unique identifier for the company. Example: Registration or UEN.|
|`name`|string|No|The registered name of the company. Optional but improves accuracy.|
---
#### **Response Format**
**Success Response**:
```json
{
"status": "Success",
"data":
{
"companyName": "Example Pte Ltd",
"registrationNumber": "201123456H",
"status": "Active",
"address":
{
"street": "123 Example Road",
"postalCode": "123456",
"city": "Singapore",
"country": "SG"
},
"dateOfIncorporation": "2010-06-15",
"businessNature": "Technology"
}
}
```
**Response Fields**:
|Field|Type|Description|
|---|---|---|
|`companyName`|string|The official name of the company.|
|`registrationNumber`|string|The unique registration number/UEN of the company.|
|`status`|string|The operational status of the company (e.g., Active, Closed).|
|`address`|object|The registered address details of the company.|
|`dateOfIncorporation`|string|The company's incorporation date in YYYY-MM-DD format.|
|`businessNature`|string|The nature of the business (e.g., Retail, Technology).|
---
#### **Error Responses**
|HTTP Code|Error Message|Description|
|---|---|---|
|`400`|`Invalid Request`|Input parameters are missing or invalid.|
|`401`|`Unauthorized`|Missing or invalid API key.|
|`404`|`Company Not Found`|No company matches the provided identifiers.|
|`500`|`Internal Server Error`|An unexpected error occurred on the server.|
---
#### **Examples**
**Request Example**:
```json
{
"countryCode": "SG",
"companyIdentifier": "201123456H",
"name": "Example Pte Ltd"
}
```
**Success Response Example**:
```json
{
"status": "Success",
"data":
{
"companyName": "Example Pte Ltd",
"registrationNumber": "201123456H",
"status": "Active",
"address":
{
"street": "123 Example Road",
"postalCode": "123456",
"city": "Singapore",
"country": "SG"
},
"dateOfIncorporation": "2010-06-15",
"businessNature": "Technology"
}
}
```
**Error Response Example**:
```json
{
"status": "Error",
"errorCode": "404",
"message": "Company Not Found"
}
```
---
#### **Notes**
- Ensure the `countryCode` corresponds to the location of the company's registration.
- Use the company’s name for better accuracy when multiple entities have similar identifiers.
- The API is optimized for Asia-based company lookups.