Skip to main content
POST

Authorizations

Authorization
string
header
required

Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty.

Body

application/json

Business registration status check request

businessRegistrationNumber
string
required

Ten-digit business registration number to check. Hyphens are allowed. The response returns ten digits with hyphens removed. The examples are test-key-only fixed numbers.

Pattern: ^\d{3}-?\d{2}-?\d{5}$
Examples:

"1000000014"

"100-00-00014"

Response

Lookup succeeded

Business registration status result. All three fields are always present, and a missing value is null.

businessRegistrationNumber
string
required

Ten-digit business registration number with hyphens removed

Pattern: ^\d{10}$
registration
object
required

Business registration state

taxType
enum<string> | null
required

GENERAL general taxpayer, SIMPLIFIED simplified taxpayer, TAX_FREE tax-exempt business, NONPROFIT nonprofit, OTHER_CORPORATION other corporation. Only an active business carries a value; the others are null.

Available options:
GENERAL,
SIMPLIFIED,
TAX_FREE,
NONPROFIT,
OTHER_CORPORATION,
null