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 /issuance/identities/businesses/{business_ref}.

Strictly scoped to the calling organization, like the person profile: the outcome and checks read the session behind its latest confirmation, the people are the operator links it covered, and the submission history is its own approved 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_outcome
enum<string>
required

What this organization's latest confirmation concluded.

Available options:
VERIFIED,
NOT_VERIFIED
checks
BusinessKybCheckResponse (v1) · object[]
required

Each check of the evaluation behind the latest confirmation, in card order; empty when checks_unavailable_reason is set.

incorporation
BusinessIncorporationResponse (v1) · object
required

The registry facts of the incorporation.

credentials
CredentialSummaryResponse (v1) · object
required

This organization's agent credentials for the business.

not_verified_reason
enum<string> | null

VERIFICATION_INCOMPLETE when the check never finished; null otherwise.

Available options:
VERIFICATION_INCOMPLETE
checks_unavailable_reason
enum<string> | null

EVIDENCE_UNAVAILABLE when the evaluation behind the latest confirmation can no longer be read (kyb_outcome still stands, as the confirmation recorded it); NO_CONFIRMED_VERIFICATION when this organization holds no confirmation of the business.

Available options:
EVIDENCE_UNAVAILABLE,
NO_CONFIRMED_VERIFICATION
last_verified_at
string<date-time> | null

When this organization's latest confirmation was recorded.

available_disclosure_paths
string[]

The subject-relative credential disclosure paths the business's records can populate, hash leaves included (e.g. hashes.ein). Paths only, never values. A requested path missing here is skipped at mint, not refused. The acting person's actor.* paths are on their person profile without the actor. prefix.

people
BusinessOperatorLinkResponse (v1) · object[]

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

submissions
IdentitySubmissionHistoryItemResponse (v1) · object[]

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