# Events

Webhooks and events · PassBook API reference. Authenticate with `Authorization: Bearer $PASSBOOK_KEY`.

## Event feed {#list}

`GET /api/v1/events`

The event feed, oldest first. Page with `after`. Takes the same events webhooks deliver.

Scopes: `passes:read`. SDK name: `pb.events.list`.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `after` | query | string |  |  |
| `types` | query | string · max 600 |  |  |
| `passId` | query | string · max 64 |  |  |
| `limit` | query | integer · ≥ 1 · ≤ 200 |  |  |
| `apiVersion` | query | "2026-12-01" |  |  |

Returns `200`, a `EventPage`.

| Code | Status | Fix |
| --- | --- | --- |
| `FORBIDDEN` |  | Use a key with the scope the operation lists, or ask an org admin. |
| `INVALID_API_KEY` |  | Create a new key in the console and update PASSBOOK_KEY. |
| `INVALID_CURSOR` |  | Pass the nextCursor from the previous page unchanged, or drop it to start over. |
| `MISSING_SCOPE` |  | Create a key with the scope the operation lists under security. |
| `PASS_NOT_FOUND` |  | Check the id with GET /api/v1/passes and the key's mode. |
| `RATE_LIMITED` |  | Wait for Retry-After seconds, then retry. Back off on repeats. |
| `UNAUTHENTICATED` |  | Send Authorization: Bearer $PASSBOOK_KEY. |
| `VALIDATION` |  | Fix each field in issues and resend. |

```sh
curl -X GET "https://passbook.mobile/api/v1/events?limit=25" \
  -H "Authorization: Bearer $PASSBOOK_KEY"
```

Response example:

```json
{
  "items": [
    {
      "id": "0193a1b2-7c00-7000-8000-0000000000e1",
      "type": "pass.issued",
      "apiVersion": "2026-12-01",
      "createdAt": 1764000000000,
      "orgId": "0193a1b2-7c00-7000-8000-0000000000a1",
      "mode": "test",
      "pass": {
        "id": "0193a1b2-7c00-7000-8000-0000000000c1",
        "externalId": "booking_8841",
        "templateId": "0193a1b2-7c00-7000-8000-0000000000b1"
      },
      "data": {
        "version": 1,
        "source": "api"
      }
    }
  ],
  "nextCursor": "ev1.4812",
  "hasMore": false
}
```

## One event by id {#retrieve}

`GET /api/v1/events/{id}`

One event by id.

Scopes: `passes:read`. SDK name: `pb.events.retrieve`.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string · max 64 | yes |  |
| `apiVersion` | query | "2026-12-01" |  |  |

Returns `200`, a `WebhookEvent`.

| Code | Status | Fix |
| --- | --- | --- |
| `FORBIDDEN` |  | Use a key with the scope the operation lists, or ask an org admin. |
| `INVALID_API_KEY` |  | Create a new key in the console and update PASSBOOK_KEY. |
| `INVALID_CURSOR` |  | Pass the nextCursor from the previous page unchanged, or drop it to start over. |
| `MISSING_SCOPE` |  | Create a key with the scope the operation lists under security. |
| `NOT_FOUND` |  | Check the id, and that the key's mode (test or live) matches the object. |
| `PASS_NOT_FOUND` |  | Check the id with GET /api/v1/passes and the key's mode. |
| `RATE_LIMITED` |  | Wait for Retry-After seconds, then retry. Back off on repeats. |
| `UNAUTHENTICATED` |  | Send Authorization: Bearer $PASSBOOK_KEY. |
| `VALIDATION` |  | Fix each field in issues and resend. |

```sh
curl -X GET "https://passbook.mobile/api/v1/events/0193a1b2-7c00-7000-8000-0000000000e1" \
  -H "Authorization: Bearer $PASSBOOK_KEY"
```

Response example:

```json
{
  "id": "0193a1b2-7c00-7000-8000-0000000000e1",
  "type": "pass.issued",
  "apiVersion": "2026-12-01",
  "createdAt": 1764000000000,
  "orgId": "0193a1b2-7c00-7000-8000-0000000000a1",
  "mode": "test",
  "pass": {
    "id": "0193a1b2-7c00-7000-8000-0000000000c1",
    "externalId": "booking_8841",
    "templateId": "0193a1b2-7c00-7000-8000-0000000000b1"
  },
  "data": {
    "version": 1,
    "source": "api"
  }
}
```
