Skip to main content
GET
Look up a verified business by pairwise reference

Authorizations

X-API-Key
string
header
required

Path Parameters

business_ref
string
required

Response

Response

Body for GET /identities/businesses/{business_ref}.

Strictly scoped to the calling organization, like the person profile: the KYB checks read its own latest covering evaluation, the people are the operator links it covered, and the submission history is its own sessions. No global business id and no EIN are ever echoed.

business_ref
string
required

The queried pairwise business reference.

The business's registered legal name.

kyb_checks
BusinessKybChecksResponse (v1) · object
required

What this organization's latest completed KYB evaluation attested to, check by check.

incorporation
BusinessIncorporationResponse (v1) · object
required

The registry facts of the incorporation.

people
BusinessOperatorLinkResponse (v1) · object[]

People this organization holds covered operator links for, each with their pairwise ref and link status.

counterparty_credentials
BusinessCounterpartyCredentialResponse (v1) · object[]

Outstanding counterparty credentials minted for the business, newest first.

submissions
IdentitySubmissionHistoryItemResponse (v1) · object[]

This organization's sessions that covered the business, newest first.