List identities

List the identities in your address book, with optional filters by type, origin, and search text. Pass address and chain to find the identity that holds an address. Page backward with last and before.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
-9007199254740991 to 200

Forward pagination: maximum number of items to return, starting after after. Range 1 to 200; defaults to 50 when omitted. Do not combine with last/before.

integer
-9007199254740991 to 200

Backward pagination: maximum number of items to return, ending before before. Range 1 to 200; defaults to 50 when omitted. Do not combine with first/after.

string
length ≥ 1

Backward-pagination cursor. Pass a pageInfo.startCursor from a previous response to fetch the page immediately before it. Use with last; do not combine with first/after.

string
length ≥ 1

Forward-pagination cursor. Pass a pageInfo.endCursor from a previous response to fetch the next page. Use with first; do not combine with last/before.

integer
-9007199254740991 to 200

Deprecated alias for first.

string
length ≥ 1

Deprecated alias for after.

string
enum

Return only identities of this type.

Allowed:
string
enum

Return only identities with this origin. directory: identities you created directly. membership: people you created as members of a company. Defaults to both.

Allowed:
string

Removed. Sending it returns 400. To list published identities, call GET /v2/identities/public.

Case-insensitive text search across firstName, lastName, companyName, and email.

boolean

Include archived records. Defaults to false.

string
length ≥ 1
\S

Return only identities that hold this address on chain. Requires chain. Any valid form of the address matches; EVM addresses are not case-sensitive. An address that is not valid for the chain returns 400.

string

Chain of the address filter. Required with address, and rejected without it.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json