Skip to main content
GET
Look up an individual by pairwise reference

Authorizations

X-API-Key
string
header
required

Path Parameters

individual_ref
string
required

Response

Response

Body for GET /issuance/identities/individuals/{individual_ref}.

Strictly scoped to the calling organization: only links it covered with its own sessions are counted, and no PII beyond what the organization itself submitted is echoed — display_name repeats the verified name the list row already returns to the same caller, nothing more.

individual_ref
string
required

The queried pairwise individual reference.

created_at
string<date-time>
required

When your organization first held a reference to the individual.

Businesses your organization holds an operator link to the individual for, in any status: the rows GET /issuance/identities/operator_links?individual_ref=… lists.

submission_count
integer
required

This organization's approved verifications of the individual: the rows of GET /issuance/identities/individuals/{individual_ref}/submissions.

credential_counts
CredentialSummaryResponse (v1) · object
required

This organization's agent credentials for the individual, counting business credentials they acted for; the rows are GET /issuance/credentials?individual_ref=….

record_count
integer
required

This organization's accepted records of the individual, the current one included: the rows of GET /issuance/identities/individuals/{individual_ref}/records.

display_name
string | null

The name on your organization's latest accepted record of the individual — the same value the list row carries. Null when your organization holds no accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.

reference_id
string | null

Your reference_id for the individual, on the reference they are listed under; null when you never sent one. A push or a PATCH answers the reference_id it wrote under.

updated_at
string<date-time> | null

When your organization's latest record of the individual was accepted: a verification or a push. Null when it holds none.

active_keys
RecordedActiveKeys · object

Each individual verification check the identity currently holds (e.g. phone_possession, ssn_identity_match), from the token-exchange profile's key vocabulary, with its basis (verified when Baselayer ran the check, attested when a customer vouched for it) and time (the UTC day, a NumericDate). A key an earlier verification proved stays held while the latest one carries the same values (the same phone for phone_possession).

available_disclosure_paths
string[]

The subject-relative credential disclosure paths a mint from the current verification can disclose: a held key proves each and a value is on file, hash leaves included (e.g. hashes.ssn). Paths only, never values. Empty when this organization holds no current verification.