Skip to main content
GET
List Identity Events

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

identity_ids
string[] | null

Filter events tied to specific user UUIDs.

changed_fields
string[] | null

Filter to events whose changed_field is one of these labels, matched exactly and case-sensitively. Use the labels changed_field returns, such as Status or Group Membership, or a custom attribute's label. An event whose custom attribute has been deleted shows -, which is not a filter value. An unrecognized label returns 400.

start_time
string<date-time> | null

Only include events detected at or after this ISO-8601 timestamp (inclusive).

end_time
string<date-time> | null

Only include events detected at or before this ISO-8601 timestamp (inclusive).

page_token
string | null

Opaque cursor from a previous response's next_page_token. Omit to fetch the first page. Treat as opaque: do not decode, construct, or interpret it.

page_size
integer
default:100

Maximum number of items to return per page. Values above 100 are clamped to 100 rather than rejected.

Required range: x >= 1

Response

Successful Response

identity_events
IdentityEvent · object[]
required

Identity events returned in this page.

next_page_token
string | null

Token for the next page, or null when this is the last page. An absent token is the only end-of-results signal. A page holding fewer than page_size items does not mean the results are exhausted. Treat the value as opaque: do not decode, construct, or interpret it.