Basic Company Check

Performs a basic existence check by matching the provided business information against authoritative data sources. This endpoint is used to verify whether a business entity exists in official or trusted registries. No detailed company profile is returned.

Request

https://openapi.advance.ai/v1/business/matches
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/matches" \
-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.
verifyResult	`enum` Company verification result.
createdAt	`string` The creation time in ISO-8601 format.

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 Examples

{
    "id": "KYBC-2014648268034936833",
    "verifyResult": "EXIST",
    "status": "COMPLETED",
    "createdAt": "2026-01-23T10:35:52Z"
}

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