Standard Company Check

Performs a standard business check and returns core company registration information. This endpoint retrieves basic company details such as registration data, legal type, and current status from official sources.

Request

https://openapi.advance.ai/v1/business/standard_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/standard_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.
verifyResult	`enum` Company verification result.
createdAt	`string` The creation time in ISO-8601 format.
registrationInfo	`object` Company registration basic 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.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.status

Registration status.

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

Response Examples

{
  "id": "KYBC-2014648268034936833",
  "status": "COMPLETED",
  "verifyResult": "EXIST",
  "createdAt": "2024-02-10T08:15:30Z",
  "registrationInfo": {
    "companyName": "ADVANCE TECH SDN BHD",
    "companyType": "ASSOCIATION",
    "companyStatus": "ACTIVE",
    "registrationDate": "2019-06-18",
    "registrationNumber": "201901023456",
    "registrationCountry": "MYS",
    "registeredCompanyAddress": "Level 10, Menara ABC, Kuala Lumpur"
  }
}

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