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/15b50870-ee7d-46a7-8eef-80f64382b42f/events \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

required
identityIdstringAn identity id.
optional
pagenumberhttps://api.jsonpad.io/identities/be1e9288-64f8-4585-907d-4551941a91a6/events?page=1The page number to fetch. Defaults to 1.
optional
limitnumberhttps://api.jsonpad.io/identities/25f204c1-1620-4154-9109-f46ff1296c0b/events?limit=20The number of events to fetch per page. Defaults to 20.
optional
orderstringhttps://api.jsonpad.io/identities/05b38876-3642-4277-8b60-e8a928c74382/events?order=createdAt
The field to order the events by. Defaults to createdAt.
Valid values are:
- createdAt
- type
optional
directionstringhttps://api.jsonpad.io/identities/cef0bca3-f0ac-4346-a6c3-17657cc7d0eb/events?direction=asc
The direction to order the events by.
Valid values are:
- asc
- desc
optional
startAtstringhttps://api.jsonpad.io/identities/0c0019e5-e920-4e3a-986c-3bc68d95f4a3/events?startAt=2026-09-23Filter for events after the specified date. This should be an ISO 8601 date.
optional
endAtstringhttps://api.jsonpad.io/identities/686df1bd-016e-49cd-bee0-0d5894686b17/events?endAt=2026-09-23Filter for events before the specified date. This should be an ISO 8601 date.
optional
typestringhttps://api.jsonpad.io/identities/afcee015-34d0-4ecf-83fa-24c15fc7c5bb/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/1d93416c-61a3-4af5-80c8-95910420ab33/events?includeSnapshot=trueInclude each event's snapshot in the response. Defaults to false.
optional
includeAttachmentsbooleanhttps://api.jsonpad.io/identities/9a1ece14-f5d2-444a-a640-defbfdc036ca/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: "d67d4f2e-440e-4bf2-8b74-6d3d67e676dd"
createdAt: "2026-09-23T21:08:43.683Z"
updatedAt: "2026-09-23T21:08:43.683Z"
user: {id: "3eb4f68b-e48b-4b1d-8e32-4b715bf065b6"
createdAt: "2026-09-23T21:08:43.683Z"
updatedAt: "2026-09-23T21:08:43.683Z"
lastActiveAt: "2026-09-23T21:08:43.683Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
modelId: "94d37b19-a893-474f-8e1b-38e4d64508d7"
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