Check Business Registration Status
Check the registration status and tax type of a single business registration number. This API requires no issuer registration, no certificate, and no client reference ID. A test key returns mock data for the fixed numbers listed in the guide. To check many numbers at once, use the bulk lookup API. Business registration status guide
Authorizations
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
Business registration status check request
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.
^\d{3}-?\d{2}-?\d{5}$"1000000014"
"100-00-00014"
Response
Lookup succeeded
Business registration status result. All three fields are always present, and a missing value is null.
Ten-digit business registration number with hyphens removed
^\d{10}$Business registration state
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.
GENERAL, SIMPLIFIED, TAX_FREE, NONPROFIT, OTHER_CORPORATION, null