Skip to main content
POST

Authorizations

Authorization
string
header
required

Append a colon to your API key, Base64-encode it, and put it in the header. 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

taxation
Taxation · object | null
required

Taxation information. null when the NTS provides no tax type. A suspended or closed business carries its last tax type when the NTS provides one.