List the people your organization has verified

get

https://api.baselayer.com/identities/principals

Lists every person your organization holds a prn_ reference for, newest verification first: their current verification state, what it can attest to, how many businesses they operate under your coverage, and how much credential activity they have seen. Filter by verification state, operator-link status and verification date; search by reference, name, email or phone. Scoped to your own population — references issued by other organizations are not listed and are not searchable.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

limit

integer

1 to 1000

Defaults to 10

Maximum number of records to return in a single page. Must be between 1 and 1000.

offset

≥ 0

Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.

cursor

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

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

operator_link_status

BusinessOperatorLinkStatus | null

Only people holding at least one operator link in this status that your organization covered.

expires_before

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

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

length ≤ 200

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

start_date

Filter records created on or after this date (format: YYYY-MM-DD).

end_date

Filter records created on or before this date (format: YYYY-MM-DD).

string

Defaults to UTC

IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/vnd.baselayer.v1+json

200Paginated identities, newest verification first, scoped to the calling organization.

422Validation Error