Fetch identity events

Fetch a page of events for an identity.

GET https://api.jsonpad.io/identities/{identityId}/events

Example

curl https://api.jsonpad.io/identities/d93509bf-e339-414b-b67a-0a335f9bfa3b/events \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

required
identityIdstringAn identity id.
optional
pagenumberhttps://api.jsonpad.io/identities/f7ec30fe-3ccc-4142-8c9c-c2cbe702e8c9/events?page=1The page number to fetch. Defaults to 1.
optional
limitnumberhttps://api.jsonpad.io/identities/f4ca66d1-c69c-4498-9491-1786571273c5/events?limit=20The number of events to fetch per page. Defaults to 20.
optional
orderstringhttps://api.jsonpad.io/identities/55f12d19-e6d5-41b7-9781-8678ff793df4/events?order=createdAt
The field to order the events by. Defaults to createdAt.
Valid values are:
- createdAt
- type
optional
directionstringhttps://api.jsonpad.io/identities/728cff03-0d03-43cb-adae-b75107d01d59/events?direction=asc
The direction to order the events by.
Valid values are:
- asc
- desc
optional
startAtstringhttps://api.jsonpad.io/identities/b96cbb2a-bb6e-4769-be31-62e8fdc34fea/events?startAt=2026-10-07Filter for events after the specified date. This should be an ISO 8601 date.
optional
endAtstringhttps://api.jsonpad.io/identities/f9e013fb-eaff-4877-adb0-0549c0926ac7/events?endAt=2026-10-07Filter for events before the specified date. This should be an ISO 8601 date.
optional
typestringhttps://api.jsonpad.io/identities/37234404-8160-4b9b-b82f-21f44882ba38/events?type=identity-updated
Filter for events by type.
Valid types are:
- identity-created
- identity-updated
- identity-updated-self
- identity-registered
- identity-logged-in
- identity-logged-out
- identity-sessions-revoked
- identity-password-reset-requested
- identity-password-reset
- identity-email-verification-requested
- identity-email-verified
- identity-provider-linked
- identity-provider-unlinked
identity-created, identity-updated and the password reset and email verification events happen when you or your server act on an identity; identity-registered, identity-logged-in, identity-logged-out, identity-updated-self and the provider events happen when the identity acts for itself. See the event log.
optional
includeSnapshotbooleanhttps://api.jsonpad.io/identities/9c5920fa-fd18-46fd-9988-d646a6540c5d/events?includeSnapshot=trueInclude each event's snapshot in the response. Defaults to false.
optional
includeAttachmentsbooleanhttps://api.jsonpad.io/identities/ffa884d8-0811-436b-a5cc-96736cbb1005/events?includeAttachments=trueInclude each event's attachments in the response. Defaults to false.

Request headers

required
x-api-tokenstringYour API token.

Request body

No request body

Response body

200 OK

{page: 1
limit: 20
total: 1
data: [0: {id: "ef601f0c-d3e4-494d-81ff-878d7690481b"
createdAt: "2026-10-07T22:12:40.039Z"
updatedAt: "2026-10-07T22:12:40.039Z"
user: {id: "ef826745-3726-4e3f-8d5e-95ebf1196d07"
createdAt: "2026-10-07T22:12:40.039Z"
updatedAt: "2026-10-07T22:12:40.039Z"
lastActiveAt: "2026-10-07T22:12:40.039Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
modelId: "c10ba229-d18d-450e-9794-de1245c5ae58"
stream: "identity"
type: "identity-created"
version: null
}
]
}

Response headers

x-total1The total number of results available.
x-pages1The total number of pages available.

2026-09-17