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.

sort
enum<string> | null

last_activity, name (legal name, ignoring case) or created_at (when your organization first held its reference); ties break on created_at, then the reference's id. Defaults to last_activity desc. What the businesses list sorts by.

Available options:
last_activity,
name,
created_at
sort_direction
enum<string> | null

asc or desc, for every key of the sort. Defaults to the field's own: last_activity desc, name asc, created_at desc.

Available options:
asc,
desc
kyb_outcome
enum<string> | null

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

Two values only: a listed business always has a KYB match behind its reference, so a check that never finished (stored NULL) is NOT_VERIFIED with BusinessNotVerifiedReason.VerificationIncomplete, not a third outcome.

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

Only businesses with at least one covered operator link in this status. Your organization's status for the link between an individual and a business they operate.

VERIFIED is earned by the full evidence recipe (TIN provided + IRS-matched + KYB-verified) on one of your own sessions, or decided by your organization; UNDER_REVIEW is every automatic shortfall; REJECTED is your organization's refusal, which stands until you decide again. Another organization's evidence or decision never changes it.

Available options:
VERIFIED,
UNDER_REVIEW,
REJECTED
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
start_date
string<date> | null

Filter records created on or after this date (format: YYYY-MM-DD).

end_date
string<date> | null

Filter records created on or before this date (format: YYYY-MM-DD).

tz
string
default:UTC

IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

Examples:

"UTC"

"America/Los_Angeles"

"Europe/London"

Response

Paginated businesses in the requested order, scoped to the calling organization.

business_ref
string
required

This organization's pairwise reference to the business.

The business's registered legal name.

incorporation_state
enum<string>
required

State of incorporation.

Available options:
AL,
AK,
AZ,
AR,
CA,
CO,
CT,
DE,
DC,
FL,
GA,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
OH,
OK,
OR,
PA,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VA,
WA,
WV,
WI,
WY,
PR,
VI,
AE,
AA,
AP,
GU,
AS
kyb_outcome
enum<string>
required

What this organization's most recent confirmation concluded.

Available options:
VERIFIED,
NOT_VERIFIED
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.

last_activity_at
string<date-time>
required

The latest of: an operator link confirmed or decided, and an agent credential issued or revoked for the business, by this organization. Starts when the business entered the directory.

linked_people_count
integer
required
read-only

Operator links this organization covers, in any status.

not_verified_reason
enum<string> | null

VERIFICATION_INCOMPLETE when the check never finished; null when verified or when it ran and failed.

Available options:
VERIFICATION_INCOMPLETE
last_verified_at
string<date-time> | null

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