> ## 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 template's notifications

> Returns the announcements sent to a template's passes, newest first.

Lists the [template announcements](https://tapace.lk/docs/api-reference/notifications/send-to-template.md) in your API key's environment, each with its `totals`. Results are [paginated](https://tapace.lk/docs/pagination.md).

**id** `string` *required*

The template 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 template doesn't exist. |

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

```json 200 theme={null}
{
  "object": "list",
  "data": [
    {
      "object": "notification",
      "id": "ntf_Bv6Kp2Wx9Lm4Tq8Rz3Nc",
      "scope": "template",
      "status": "sent",
      "appleText": "Doors open at 7 tonight.",
      "audience": 42,
      "totals": {
        "pending": 0,
        "apple": { "delivered": 30, "devices": 31, "notInstalled": 2, "failed": 0, "skipped": 0 },
        "google": { "sent": 9, "limitReached": 1, "notSaved": 0, "failed": 0, "skipped": 0 }
      },
      "sentAt": "2026-10-18T13:30:08.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```


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