Skip to main content
GET
List the individuals your organization has onboarded

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 (given then family name, ignoring case) or updated_at; ties break on when the record was created, then its id. Defaults to last_activity desc. What the people list sorts by.

Available options:
last_activity,
name,
updated_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, updated_at desc.

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

linked (a verified link to a business), link_request (a link awaiting your review) or none (no business, or only rejected links). Your organization's own links only. The people list's business segments, read off the organization's own operator links.

Available options:
linked,
link_request,
none
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 in the requested order, scoped to the calling organization.

individual_ref
string
required

This organization's pairwise reference to the individual.

display_name
string
required

The name on your organization's latest accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.

linked_business_count
integer
required

Businesses this organization covers a live operator link to for the individual; rejected links are not counted. The rows are GET /issuance/identities/operator_links?individual_ref=…&status=verified&status=under_review.

last_activity_at
string<date-time>
required

The latest of: a record of them accepted (a verification or a push), a link confirmed or decided, an agent credential issued or revoked. Your organization's own activity only.

credentials_issued_30d
integer
required

Credentials this organization issued for the individual in the last 30 days, counting business credentials it acted for: credential_counts.issued_30d on the individual's read.

created_at
string<date-time>
required

When your organization first held a reference to the individual.

updated_at
string<date-time>
required

When your organization's latest record of the individual was accepted: a verification or a push.

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).

reference_id
string | null

Your reference_id for the individual, on the reference they are listed under; null when you never sent one.