Skip to main content
GET
List the people 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.

verification_state
enum<string> | null

Only identities in this derived state. SUPERSEDED never matches: the list carries one row per person — their current verification — and superseded snapshots are lineage, not population. Verification state of an identity, as seen by the referencing organization.

CURRENT: an unexpired verification exists and credentials can be minted. EXPIRED: the verification's validity window has lapsed — re-verify before minting. SUPERSEDED: no active verification record remains; a new submission is required.

Available options:
CURRENT,
EXPIRED,
SUPERSEDED
operator_link_status
enum<string> | null

Only people holding at least one operator link in this status that your organization covered. 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
expires_before
string<date-time> | null

Only identities whose verification expires strictly before this instant — pass now + 30 days for the "expiring soon" needs-attention window. Already-expired identities match too; combine with verification_state to separate them. Must carry a UTC offset.

mint_failed_since
string<date-time> | null

Only identities your active application saw a typed credential mint refusal for at or after this instant. Must carry a UTC offset.

search
string | null

A prn_ reference, or free text matched against name, email and phone. Every whitespace-separated term must match.

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 identities, newest verification first, scoped to the calling organization.

principal_ref
string
required

This organization's pairwise reference to the person.

display_name
string
required

The verified name, as the latest snapshot recorded it. Mask it in shared surfaces; the API returns what the organization itself submitted.

verification_state
enum<string>
required

CURRENT, or EXPIRED (re-verify before minting). Derived from the snapshot's validity window, never stored.

Available options:
CURRENT,
EXPIRED,
SUPERSEDED
linked_business_count
integer
required

Businesses this organization covers a live operator link to for the person; rejected links are not counted.

credentials_minted_30d
integer
required

Credentials this organization minted for the person in the last 30 days, counting business credentials it acted for.

verified_at
string<date-time>
required

When the latest verification was recorded.

expires_at
string<date-time>
required

When the latest verification expires.

verification_level
integer | null

Verification level derived from active_keys; null when the attested attributes are insufficient for any defined level.

active_keys
string[]

Dotted keys of the attributes the latest verification can attest to — the vocabulary credential disclosure uses.