---
title: Global KYB Asia UBO Initiate
slug: us-apis/global-kyb-asia-ubo-initiate
description: The Global Business Entity ID Lookup API is an efficient tool for accessing comprehensive and reliable information about businesses worldwide, utilizing their unique entity identification codes. With its capability to swiftly retrieve company details, thi
createdAt: 2023-09-28T15:27:15.815Z
---

# Introduction

The **Global KYB Asia UBO Initiate** service is designed to streamline the process of identifying and verifying Ultimate Beneficial Owners (UBOs) across Asian jurisdictions. As part of the broader KYB (Know Your Business) framework, this solution enables businesses to initiate UBO checks efficiently, ensuring transparency in ownership structures and compliance with regulatory requirements.

# Use Cases:

1. **Merchant Onboarding and KYB Compliance:**
   Streamlining the onboarding process for merchants is crucial for various industries, especially in e-commerce, finance, and payment processing sectors. This API facilitates quick and accurate verification of company details across multiple countries, aiding in Know Your Business (KYB) compliance and expediting the merchant approval process. It ensures businesses onboard legitimate entities, reducing risks associated with fraud or non-compliance.
2. **International Business Partnerships and Due Diligence:**
   For companies expanding or collaborating across borders, verifying the legitimacy and details of potential partners or clients is pivotal. This API enables swift access to essential company information, assisting in due diligence processes. It helps in evaluating the credibility of partners, ensuring compliance with regulatory requirements, and mitigating risks associated with international business ventures.
3. **Financial Services and Risk Assessment:**
   Financial institutions rely heavily on accurate company data for risk assessment, credit evaluation, and ensuring the integrity of their client base. This API expedites the retrieval of official company details, aiding in efficient risk analysis and assessment for loan approvals, credit scoring, and other financial services. It assists in making informed decisions while minimizing exposure to potential risks.

# Supported Countries



| **Country** | **Country Code** |
| ----------- | ---------------- |
| Australia   | AU               |
| China       | CN               |
| Hong Kong   | HK               |
| Malaysia    | MY               |
| New Zealand | NZ               |
| Singapore   | SG               |
| Taiwan      | TW               |
| Vietnam     | VN               |



# API Details

:::CodeblockTabs
Production

```curl
curl --location 'https://api.signzy.app/api/v3/global/kyb-asia-v2-ubo' \
--header 'Content-Type: application/json' \
--header 'Authorization: XXXXXXXXXXX' \
--data '
{
  "countryCode": "CN",
  "companyNumber": "911101163354814080",
  "uboDetails": {
    "threshold": "25",
    "layers": "1"
  },
  "notifyURL": ""
}'
```

Pre-Production

```curl
curl --location 'https://api-preproduction.signzy.app/api/v3/global/kyb-asia-v2-ubo' \
--header 'Content-Type: application/json' \
--header 'Authorization: XXXXXXXXXXX' \
--data '
{
  "countryCode": "CN",
  "companyNumber": "911101163354814080",
  "uboDetails": {
    "threshold": "25",
    "layers": "1"
  },
  "notifyURL": ""
}'
```
:::

## API Input

### Input Parameters



| Input                | Description                                                                                            | Data Type  | Mandatory |
| -------------------- | ------------------------------------------------------------------------------------------------------ | ---------- | --------- |
| countryCode          | 2 Letter ISO country code                                                                              | string     | Yes       |
| companyNumber        | Registration number of the company                                                                     | string     | Yes       |
| uboDetails.threshold | Threshold above which an individual is considered a UBO<br />Accepted values: 10, 15 and 25            | string     | Yes       |
| uboDetails.layers    | Number of layers to be uncovered for UBO Discovery. Higher the number of layers, higher RT and charges | string     | Yes       |
| notifyURL            | Callback URL where data is pushed                                                                      | string     | No        |



### Sample Response&#x20;

```json
{
    "result": {
        "requestId": "69e6158027cf11d5a5ebb053",
        "countryCode": "CN",
        "status": "PENDING",
        "message": "UBO request accepted"
    },
    "reason": "Request Successful",
    "code": "S001"
}
```

### Sample Error

:::CodeblockTabs
E401 Upstream Failure

```json
{
    "result": {},
    "reason": "Upstream error",
    "status": "failure",
    "code": "E401"
}
```

E001 Bad Request

```json
{
    "result": {},
    "reason": "countryCode must be one of CN, HK, TW, VN, SG, AU, NZ, MY",
    "code": "E001"
}
________________________________________________________________________________________

{
    "result": {},
    "reason": "threshold must be one of 10, 15, or 25",
    "code": "E001"
}
_______________________________________________________________________________________

{
    "result": {},
    "reason": "layers must be between 1 and 20",
    "code": "E001"
}
```

E301 Data Not Found

```json
{
    "result": {},
    "reason": "Data Not Found",
    "code": "E301"
}
```
:::

### Error Response Parameters

| **Parameter** | **Description**        |
| ------------- | ---------------------- |
| result        | Empty result object    |
| reason        | Reason for error       |
| status        | Status of the api      |
| code          | Error code from Signzy |

### Error Codes

| HTTP Status Code | Error Code | Description           |
| ---------------- | ---------- | --------------------- |
| 400              | E001       | Bad Request           |
| 401              | E1001      | Unauthorized Access   |
| 403              | E201       | Forbidden             |
| 404              | E301       | Data Not Found        |
| 409              | E401       | Upstream error        |
| 429              | E501       | Rate Limit Exceeded   |
| 500              | E601       | Internal Server Error |
| 503              | E701       | Service Unavailable   |
| 504              | E801       | Timeout               |

### Success Codes

| HTTP Status Code | Success Code | Description               |
| ---------------- | ------------ | ------------------------- |
| 200              | S001         | Request Successful.       |
| 200              | S003         | Data not Found on source. |



:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
:::

