Create Company Check

This endpoint initiates a KYB (Know Your Business) verification request. Submit a company's basic information to query its official registration status and core details from authoritative government registries.

Request

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

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

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

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

https://openapi.advance.ai/v1/business/companies/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)	Description
companyName	`string` [required] The name of the company to be checked.
country	`string` [required] 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	`string` [required] The registration number of the company.

Request Examples

curl -X POST "https://openapi.advance.ai/v1/business/companies/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.
vendorId	`string` The vendor id associated with this check.
status	`enum` Company verification check status.
verifyResult	`enum` Company verification result.
createdAt	`string` The creation time in ISO-8601 format.
registrationInfo	`object` Company registration basic information.
officersInfos	`array<object>` List of company officers information.
shareholdersInfos	`array<object>` List of company shareholders information.

Response.data.registrationInfo

Company registration information.

Field	Description
companyName	`string` Registered company name.
companyType	`enum` Legal type of the company.
companyStatus	`enum` Current registration status.
registrationDate	`string` Company registration date in yyyy-MM-dd format.
registrationNumber	`string` Official registration number.
registrationCountry	`string` Country of registration.
registeredCompanyAddress	`string` Registered company address.

Response.data.officersInfos

Company officer information list.

Field	Description
id	`string` Officer unique identifier.
name	`string` Officer full name.
idType	`enum` Officer identification type.
role	`enum` Officer role in the company.
type	`enum` Entity type
status	`enum` Officer current status.
address	`string` Officer registered address.
nationality	`string` Officer nationality. ISO-3166-1 alpha-3 code.
dateOfBirth	`string` Officer date of birth in yyyy-MM-dd format.
appointmentDate	`string` Officer appointment date.

Response.data.shareholdersInfos

Company shareholder information list.

Field	Description
id	`string` Shareholder unique identifier.
idType	`enum` Shareholder identification type.
name	`string` Shareholder name.
status	`enum` Shareholder status.
type	`enum` Entity type.
address	`string` Shareholder address.
currency	`string` Currency of shareholding.
shareType	`enum` Share type.
ownerships	`string` Shareholding ratio or description.
nationality	`string` Shareholder nationality. ISO-3166-1 alpha-3 code.

Response.data.status

KYB Company Check Status

Value	Description
IN_PROGRESS	In Progress
COMPLETED	Completed
ERROR	Error

Response.data.verifyResult

Company verification result

Value	Description
EXIST	Company exists in the official registry.
NO_EXIST	Company not found in the official registry

Response.data.registrationInfo.companyType

Company legal entity type

Value	Description
PRIVATE_LIMITED_LIABILITY_COMPANY	Private Limited Liability Company.
PUBLIC_LIMITED_LIABILITY_COMPANY	Public Limited Liability Company.
LIMITED_LIABILITY_COMPANY	Limited Liability Company.
FOUNDATION	Foundation.
ASSOCIATION	Association.
COOPERATIVE	Cooperative.
LIMITED_PARTNERSHIP	Limited Partnership.
SOLE_PROPRIETORSHIP	Sole Proprietorship.
FEDERATION_OF_FIRMS	Federation of Firms.
CIVIL_PARTNERSHIP	Civil Partnership.
GENERAL_PARTNERSHIP	General Partnership.
PUBLIC_UTILITY_COMPANY	Public Utility Company.
STATE_OWNED_COMPANY	State-owned Company.
OTHERS	Other or unclassified legal entity types.

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.role

Officer role in the company.

Value	Description
DIRECTOR	Company director.
MANAGING_DIRECTOR	Managing director.
SECRETARY	Company secretary.
PARTNER	Business partner.
MEMBER	Company member.
CORPORATE_REPRESENTATIVE	Corporate legal representative.
AUDITOR	Company auditor.
LIQUIDATOR	Company liquidator.
GOVERNMENT_APPOINTEE	Government-appointed officer.
OTHER	Other officer role.

Response.data.infos.type

Entity classification type.

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

Response.data.infos.status

Registration status.

Value	Description
ACTIVE	The role is currently active.
INACTIVE	The role is no longer active.
OTHER	Other or unknown status.

Response.data.Infos.shareType

Share type of the shareholder.

Value	Description
ORDINART	Ordinary shares.
PREFERENCE	Preference shares.
OTHER	Other or unspecified share type.

Response Examples

{
    "id": "KYBC-2014648268034936833",
    "vendorId": "36dd4485-c114-4a34-b3f1-c55234f70088",
    "verifyResult": "EXIST",
    "createdAt": "2026-01-23T10:35:52Z",
    "registrationInfo": null,
    "officersInfos": null,
    "shareholdersInfos": null
}

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 6 days ago