---
title: "List a webhook endpoint's deliveries"
method: GET
path: "/webhooks/{id}/deliveries"
tags: ["Webhooks"]
---

# List a webhook endpoint's deliveries

`GET /webhooks/{id}/deliveries`

Returns the endpoint's delivery log, newest first, with native cursor pagination. Pass limit (1-100) and cursor query params. Requires the webhooks.manage permission.

## Path parameters

- `id` string, required — Webhook endpoint id.

## Query parameters

- `limit` string — Page size 1-100 (default 25), enforced by the handler.
- `cursor` string — Opaque continuation cursor from a prior page's continueCursor.

## Response `200`

Cursor-paginated result. continueCursor is non-null even when isDone is true.

- object
  - `page` WebhookDelivery[], required
    - `id` string, required — Delivery-log row id.
    - `idempotencyId` string, required — Stable evt_ id, reused across retries (idempotency key).
    - `event` string, required — The delivered event name.
    - `status` 'pending' | 'delivering' | 'delivered' | 'failed' | 'dead_lettered', required — Lifecycle status of one logical delivery (endpoint x idempotency id).
    - `attemptCount` integer, required — Number of delivery attempts made.
    - `statusCode` integer, nullable, required — Last HTTP response status, or null.
    - `errorMessage` string, nullable, required — Last error message, or null.
    - `nextAttemptAt` number, nullable, required — Epoch ms of the next scheduled retry, or null.
    - `isTest` boolean, required — True for test.ping deliveries.
    - `createdAt` number, required — Emit/creation epoch ms (retention key).
    - `updatedAt` number, required — Last update epoch ms.
    - `deliveredAt` number, nullable, required — Epoch ms of successful delivery, or null.
  - `isDone` boolean, required
  - `continueCursor` string, required

## Other responses

- `400` — Bad request (invalid body, cursor, limit, or date).
- `401` — Missing or invalid API key.
- `403` — API key lacks the required permission.
- `404` — Resource not found.
- `429` — Rate limited.

---

[API](https://skmtc.net/teambattles/apis/teambattles-api.md) · [All operations](https://skmtc.net/teambattles/apis/teambattles-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teambattles/teambattles-api/revisions/2ffe8fb53b7d/schema)