Search identities.

get

https://localhost/irs/identities/v1/search

Returns a paginated list of identities filtered by identity columns or metadata buckets.
Filters use the filter[<source>.<path>] syntax where source is identity, public, or admin.
The filter[query] parameter enables a configurable "universal search" across multiple fields (operator: contains).
Predicates are specified as <operator>:<value>.
Supported operators: eq, neq, in, lt, le, ge, startswith, endswith, contains, null, notnull.
The endpoint expects a session token either in "Authorization Bearer" or the configured session cookie.
Provide the X-IRS-CSRF-Token header when the session cookie is used.

Query Params

limit

integer

Page size (default 50, maximum 200)

page

integer

1-based page number (default 1)

filter[query]

string

Universal search query using : (example: 'contains:john doe')

filter[identity.<field>]

string

Filter identity columns using : (example: 'eq:active')

filter[identity.type]

string

Filter identity types using eq: or in:<type1,type2>

filter[public.<field>]

string

Filter public metadata using : or in: list predicates

filter[admin.<field>]

string

Filter admin metadata using : or in: list predicates

filter[identifiers.<name>]

string

Filter identity identifiers (email, phone, etc.) using the same operators as identity fields

sort

string

Sorting instructions, e.g. '-identity.createdAt'; multiple sorts comma separated

Headers

Authorization

string

Session token provided in Authorization Bearer

string

Session token provided in a cookie

X-IRS-CSRF-Token

string

CSRF Token

Responses

200Identities that match the search criteria

400Validation error or malformed query

401Unauthorized - Token missing or invalid, session inactive or expired, or CSRF token mismatch

500The server cannot process the request