---
title: "List an endpoint's deliveries, newest first"
method: GET
path: "/webhooks/{id}/deliveries"
tags: ["Webhooks"]
---

# List an endpoint's deliveries, newest first

`GET /webhooks/{id}/deliveries`

## Request

- Base URL: `https://gtmswag.com/api/v1`
- URL: `https://gtmswag.com/api/v1/webhooks/{id}/deliveries`
- Auth: HTTP bearer

Delivery attempts for gift events (`source=gift`, default) or playbook events (`source=playbook`), each with `state` `pending`, `sending`, `delivered` or `dead` (after 8 failed attempts). Page with `before` = the previous `nextBefore`. Owner or admin keys only.

## Path parameters

- `id` string, required

## Query parameters

- `before` integer
- `limit` integer
- `source` 'gift' | 'playbook'

## Response `200`

Success: `{"data": WebhookDeliveriesPage}`.

- WebhookDeliveriesPageResponse: The success body: `{"data": WebhookDeliveriesPage}`.
  - `data` WebhookDeliveriesPage, required: One page of an endpoint's deliveries, newest first; pass `nextBefore` as `before`.
    - `items` object[], required
      - `id` integer, required: Delivery ID, unique per source.
      - `event_seq` integer, required
      - `type` string, required
      - `source` 'gift' | 'playbook', required
      - `state` 'pending' | 'sending' | 'delivered' | 'dead', required
      - `attempts` integer, required
      - `next_at` integer, required: Next attempt, Unix ms.
      - `last_status` integer, nullable, required
      - `last_error` string, nullable, required
    - `nextBefore` integer, nullable, required

## Other responses

- `400`: Bad request: `VALIDATION_ERROR`. Each example says when.
- `401`: Not authenticated: `AUTH_REQUIRED`. no credentials, or an OAuth token on a route that only takes workspace keys; the key is malformed, unknown or revoked.
- `403`: Forbidden: `TEAM_MANAGER_REQUIRED`. Each example says when.
- `429`: Too many requests: `RATE_LIMIT`. more than 240 requests in the current minute for this workspace (REST and MCP share the limit); wait `retryAfterMs`.
- `default`: Any other refusal or failure, such as 403 CSRF (a cross-origin `Origin` header), 403 HTTPS_REQUIRED or 500 INTERNAL_ERROR, with what to do next.

---

[API](https://skmtc.dev/gtmswag/apis/gtm-swag-api.md) · [All operations](https://skmtc.dev/gtmswag/apis/gtm-swag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gtmswag/apis/gtm-swag-api/revisions/9ff86fa99afe?raw)