Skip to main content
GET
List the businesses your organization has verified

Authorizations

X-API-Key
string
header
required

Query Parameters

limit
integer
default:10

Maximum number of records to return in a single page. Must be between 1 and 1000.

Required range: 1 <= x <= 1000
offset
integer | null

Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.

Required range: x >= 0
cursor
string | null

Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.

kyb_outcome
enum<string> | null

Only businesses whose latest evaluation by your organization reached this outcome. What the organization's latest covering evaluation concluded about a business.

Sourced from BusinessOperatorLinkConfirmation.kyb_verified, which is tri-state on purpose: INDETERMINATE means no determination was reached (the check never ran, or the registry was silent), which is not the same claim as NOT_VERIFIED — the business was checked and did not verify.

Available options:
VERIFIED,
NOT_VERIFIED,
INDETERMINATE
operator_link_status
enum<string> | null

Only businesses with at least one covered operator link in this status. Status of the link between a person (principal) and a business they operate.

VERIFIED is earned by the full evidence recipe (TIN provided + IRS-matched + KYB-verified) or granted by manual review; UNDER_REVIEW is every automatic shortfall; REJECTED is a manual refusal. A rejected link is immutable — a later submission evaluates the pair fresh.

Available options:
VERIFIED,
UNDER_REVIEW,
REJECTED
mint_failed_since
string<date-time> | null

Only businesses your active application saw a typed credential mint refusal for at or after this instant — the counterparty mint's refusals, which name a business and no person, and the business mints' refusals, which name both. Must carry a UTC offset.

search
string | null

A bus_ reference, or free text matched against the registered business name; nine digits also match as an exact EIN.

Maximum string length: 200

Response

Paginated businesses, most recently onboarded first, scoped to the calling organization.

business_ref
string
required

This organization's pairwise reference to the business.

The business's registered legal name.

kyb_outcome
enum<string>
required

What this organization's most recent covering evaluation concluded. INDETERMINATE means no determination was reached — including a business it has never covered — which is not the same as NOT_VERIFIED.

Available options:
VERIFIED,
NOT_VERIFIED,
INDETERMINATE
verified_people_count
integer
required

Covered operator links in VERIFIED — people who can mint.

under_review_people_count
integer
required

Covered operator links in UNDER_REVIEW — business mints for these people are refused until a reviewer decides.

rejected_people_count
integer
required

Covered operator links a reviewer rejected.

linked_people_count
integer
required
read-only

Operator links this organization covers, in any status.

last_verified_at
string<date-time> | null

When this organization last covered the business with an evaluation of its own.