Skip to main content
POST
Check Business Registry

Authorizations

X-API-Key
string
header
required

API Key

Headers

IDEMPOTENCY-KEY
string
required

a UUID ensuring a registry check is only processed once

X-SUB-PARTNER-ID
string

Optional sub-partner UUID, if provided, the check runs under scope of the sub-partner

X-API-Version
string

Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01, 2026-08-01, 2026-10-01, 2026-10-15.

Path Parameters

id
string<uuid>
required

the ID of the business Customer to check

Body

application/json; charset=utf-8

Business Registry Check Params

The business as it will be submitted in the identification. A match is honoured at submission only when the name, registration number and state are identical.

company_name
string
required

Registered legal name of the business.

country
string
required

ISO 3166-1 alpha-2 country of registration. Only US is supported.

registration_number
string
required

The state registry's entity or file number (not the EIN).

registration_state
string

Two-letter code or name of the state the business is registered in.

Response

Business Registry Check

checked_at
string<date-time>
required
id
string<uuid>
required
result
enum<string>
required
Available options:
match,
no_match