Beneficial Owner Check

Performs a Beneficial Ownership (BO) check and returns detailed information about the company’s beneficial owners. This endpoint identifies individuals who ultimately own or control the business, supporting regulatory and compliance requirements.

Request

https://openapi.advance.ai/v1/business/bo_checks
POST (application/json)

Request Header Parameters

Parameter	Description
X-ACCESS-TOKEN	`string` Please use Token Authentication API to get your access token.

Request Parameters

Parameter)	Required	Description
companyName	True	`string` The name of the company to be checked.
country	True	`string` The country of the company, The country of the company. Accepts country full name, ISO-3166-1 alpha-2 code, or ISO-3166-1 alpha-3 code. Recommendation: Please use ISO-3166-1 alpha-3 codes where possible. Example formats: "Singapore", "SG", "SGP"
registrationNumber	True	`string` The registration number of the company.

Request Examples

curl -X POST "https://openapi.advance.ai/v1/business/bo_checks" \
-H "X-ACCESS-TOKEN: {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "companyName": "Official company",
  "country": SGP",
  "registrationNumber": "184671112D"
}'

Success Response

Response Description

Field	Description
id	`string` The unique id of the company check result.
status	`enum` Company verification check status.
createdAt	`string` The creation time in ISO-8601 format.
count	`number` Total number of beneficial owners identified for the company.
boInfos	`array<object>` List of beneficial owner details identified for the company.

Response.data.boInfos

Beneficial owner information.

Field	Description
name	`string` Name of the beneficial owner.
type	`enum` Entity type of the beneficial owner.
idType	`enum` Identification type of the beneficial owner.
address	`string` Registered address of the beneficial owner.
ownership	`number` Ownership percentage of the beneficial owner.
nationality	`string` Nationality of the beneficial owner.

Response.data.status

KYB Company Check Status

Value	Description
IN_PROGRESS	In Progress
COMPLETED	Completed
ERROR	Error

Response.data.infos.idType

Identification document type.

Value	Description
PERSON_NATIONAL_ID	National ID of an individual.
PERSON_FOREIGN_ID	Foreign ID of an individual.
PASSPORT	Passport.
COMPANY_ID	Company registration ID.
GOVERNMENT_ENTITY	Government entity identification.
OTHER_ORG_ID	Other organization identification.
UNKNOWN_OR_UNDOCUMENTED	Unknown or undocumented identification.
OTHER	Other identification type

Response.data.infos.type

Entity classification type.

Value	Description
COMPANY	The entity is a company.
INDIVIDUAL	The entity is an individual.

Response Examples

{
  "id": "KYBC-2014648268034936833",
  "status": "COMPLETED",
  "createdAt": "2024-02-10T09:30:00Z",
  "count": 2,
  "boInfos": [
    {
      "name": "Lim Wei Jian",
      "type": "INDIVIDUAL",
      "idType": "PASSPORT",
      "address": "Petaling Jaya, Selangor",
      "ownership": 60.00,
      "nationality": "MYS"
    },
    {
      "name": "Advance Holdings Pte Ltd",
      "type": "COMPANY",
      "idType": "COMPANY_ID",
      "address": "Petaling Jaya, Selangor",
      "ownership": 40.00,
      "nationality": "MYS"
    }
  ]
}

Error Response

Response Description

The standard error response object.

Parameter	Description
error	`object` The error details.

ResponseError.error

Field	Description
type	`string` Error code or type.
message	`string` Human-readable error message.

ResponseError.error.type

Value	Description	HTTP Status Code
parameter_error	Parameter validation failed (e.g., missing or invalid parameter).	400 Bad Request
iam_failed	Authentication or authorization failed.	401 Unauthorized
error	Internal server error or unknown error.	500 Internal Server Error
not_found	Requested resource not found.	404 Not Found
service_busy	The service is busy or rate limited.	429 Too Many Requests

Response Examples

{
  "error": {
    "type": "parameter_error",
    "message": "ID cannot be empty"
  }
}

Updated about 12 hours ago