No results

Fetch identity events

Fetch a page of events for an identity.

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

Example

cURL
123curl https://api.jsonpad.io/identities/a8986217-7bb7-458d-a987-aea836f6db3e/events \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

  • required
    identityIdstringAn identity id.
  • optional
    pagenumberhttps://api.jsonpad.io/identities/36e8e22d-5380-458f-a470-0a7d3891d0e4/events?page=1The page number to fetch. Defaults to 1.
  • optional
    limitnumberhttps://api.jsonpad.io/identities/fc6b0a10-a546-43fa-a313-739463e75fe1/events?limit=20The number of events to fetch per page. Defaults to 20.
  • optional
    orderstringhttps://api.jsonpad.io/identities/d51d37ec-c199-4e13-aab9-088f1f0e9f89/events?order=createdAt

    The field to order the events by. Defaults to createdAt.

    Valid values are:

    • createdAt
    • type
  • optional
    directionstringhttps://api.jsonpad.io/identities/dcc9e725-bb0d-4566-a2d1-12ad561783a8/events?direction=asc

    The direction to order the events by.

    Valid values are:

    • asc
    • desc
  • optional
    startAtstringhttps://api.jsonpad.io/identities/7119ae40-9624-48dd-882d-9a3f92108b15/events?startAt=2026-09-05Filter for events after the specified date. This should be an ISO 8601 date.
  • optional
    endAtstringhttps://api.jsonpad.io/identities/931e8aab-8e83-43fa-9fd1-cca57cd1cfb4/events?endAt=2026-09-05Filter for events before the specified date. This should be an ISO 8601 date.
  • optional
    typestringhttps://api.jsonpad.io/identities/a8e5f4cf-9ed1-42ec-8bf1-03e746c54cb4/events?type=identity-updated

    Filter for events by type.

    Valid types are:

    • identity-created
    • identity-updated
    • identity-registered
    • identity-logged-in
    • identity-logged-out

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: "aac75fbd-fdae-4da5-81af-eccef8d40b6c"
createdAt: "2026-09-05T11:30:32.455Z"
updatedAt: "2026-09-05T11:30:32.455Z"
user: {
id: "d7c54c24-cb14-4d79-a0c2-5805b319b2d4"
createdAt: "2026-09-05T11:30:32.455Z"
updatedAt: "2026-09-05T11:30:32.455Z"
lastActiveAt: "2026-09-05T11:30:32.455Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
modelId: "f1fa1215-1035-448a-9bd9-14afebf8ae60"
stream: "identity"
type: "identity-created"
version: null
snapshot: {
id: "f1fa1215-1035-448a-9bd9-14afebf8ae60"
name: "Sample Identity"
type: "identity"
locked: false
userId: "22360fcf-6b76-4794-b4e9-c4c2ad94f666"
createdAt: "2026-09-05T11:30:32.455Z"
updatedAt: "2026-09-05T11:30:32.455Z"
}
attachments: {
data: {
name: "Sample Identity"
}
}
}
]
}

Response headers

  • x-total1The total number of results available.
  • x-pages1The total number of pages available.
2024-12-12