> ## Documentation Index
> Fetch the complete documentation index at: https://tapace.lk/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List a pass's notifications

> Returns every message a pass received, newest first.

Includes messages sent to this pass, template announcements it received, and messages sent with a [deployment](https://tapace.lk/docs/api-reference/deployments/create.md). Each item's `delivery` shows how it reached this pass. Results are [paginated](https://tapace.lk/docs/pagination.md).

**id** `string` *required*

The pass ID.

**limit** `integer` (default: 25)

Items per page, from 1 to 100.

**cursor** `string`

The `nextCursor` from the previous page.

### Errors

| Status | When |
| - | - |
| `404` | The pass doesn't exist. |

```bash cURL theme={null}
curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/notifications \
  -H "Authorization: Bearer $TAPACE_API_KEY"
```

```json 200 theme={null}
{
  "object": "list",
  "data": [
    {
      "object": "notification",
      "id": "ntf_Qm3Vx8Lt2Nr7Kp4Zs9Wc",
      "scope": "pass",
      "environment": "test",
      "templateId": "tmpl_Q4vN8xT2mLr7KpZs3Wd1",
      "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
      "deploymentId": null,
      "deploymentRevision": null,
      "appleText": "Your table is ready.",
      "googleTitle": "Table ready",
      "googleBody": "Your table is ready. Please come to the front desk.",
      "status": "sent",
      "statusReason": null,
      "scheduledFor": null,
      "audience": 1,
      "actor": { "id": "cmgx4k2p90001ab12cd34ef56", "name": null, "email": null },
      "totals": null,
      "delivery": {
        "skipReason": null,
        "apple": { "status": "delivered", "devices": 1, "error": null },
        "google": { "status": "delivered", "message": "sent", "error": null }
      },
      "createdAt": "2026-10-18T09:00:00.000Z",
      "updatedAt": "2026-10-18T09:00:03.000Z",
      "startedAt": "2026-10-18T09:00:01.000Z",
      "sentAt": "2026-10-18T09:00:03.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.