# List user events

GraphQL endpoint: `/user`

Lists the events a partner application recorded about the calling user, most recently recorded first, cursor-paginated. Called with the user's own session and an `event_token` minted by the partner's backend (`POST /auth/user-event-token`); only events under that company's prefix are returned.

Filter with `typePrefix` (which must start with the company's prefix, e.g. `hoozit.order`) and with `occurredFrom` (inclusive) and `occurredTo` (exclusive). Pass paginationInfo.nextCursor back as the cursor argument to fetch the next page.

## Query

```graphql
query (
  $eventToken: String!
  $typePrefix: String
  $occurredFrom: DateTime
  $occurredTo: DateTime
  $limit: Int
  $cursor: String
) {
  userEvents(
    eventToken: $eventToken
    typePrefix: $typePrefix
    occurredFrom: $occurredFrom
    occurredTo: $occurredTo
    limit: $limit
    cursor: $cursor
  ) {
    paginationInfo { limit nextCursor }
    records { id type payload externalRef occurredAt recordedAt subjectUserId actorUserId }
  }
}

```

## Variables

```json
{
  "eventToken": "eyJERAMPLE.PAYLOAD1.SIGNATURE",
  "limit": 2
}
```

## Response

```json
{
  "data": {
    "userEvents": {
      "paginationInfo": {
        "limit": 2,
        "nextCursor": "MjAyNi0xMS0wNVQwOToyNjozOS42MTI2MjR8fDY0MTU0MTAzLWM0M2YtNDgyZi1hNzMzLTczZWE5NzFlOGVmYQ=="
      },
      "records": [
        {
          "actorUserId": "00000000-0000-4000-8000-000000000001",
          "externalRef": "ref-2",
          "id": "00000000-0000-4000-8000-000000000002",
          "occurredAt": "2026-01-15T09:00:02.000000Z",
          "payload": {
            "n": 3
          },
          "recordedAt": "2026-01-15T09:00:03.000000",
          "subjectUserId": "00000000-0000-4000-8000-000000000001",
          "type": "hoozit.thing.happened"
        },
        {
          "actorUserId": "00000000-0000-4000-8000-000000000001",
          "externalRef": "ref-1",
          "id": "00000000-0000-4000-8000-000000000003",
          "occurredAt": "2026-01-15T09:00:00.000000Z",
          "payload": {
            "n": 2
          },
          "recordedAt": "2026-01-15T09:00:01.000000",
          "subjectUserId": "00000000-0000-4000-8000-000000000001",
          "type": "hoozit.thing.happened"
        }
      ]
    }
  }
}
```