---
title: "List webhook deliveries"
method: GET
path: "/webhooks/deliveries"
tags: ["Webhook Deliveries"]
---

# List webhook deliveries

`GET /webhooks/deliveries`

Returns a paginated list of webhook delivery attempts. Each delivery
includes a nested `email` object with sender, recipient, and subject.

## Query parameters

- `cursor` string
- `limit` integer
- `email_id` string, uuid
- `status` 'pending' | 'delivered' | 'header_confirmed' | 'failed'
- `date_from` string, date-time
- `date_to` string, date-time

## Response `200`

Paginated list of deliveries

- object
  - `success` true, required
  - `meta` object, required
    - `total` integer, required — Total number of matching records
    - `limit` integer, required — Page size used for this request
    - `cursor` string, nullable, required — Cursor for the next page, or null if no more results
  - `data` object[], required
    - `id` string, required — Delivery ID (numeric string)
    - `email_id` string, uuid, required
    - `org_id` string, uuid, required
    - `endpoint_id` string, uuid, required
    - `endpoint_url` string, required
    - `status` 'pending' | 'delivered' | 'header_confirmed' | 'failed', required
    - `attempt_count` integer, required
    - `duration_ms` integer, nullable
    - `last_error` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `email` object, nullable
      - `sender` string, required
      - `recipient` string, required
      - `subject` string, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key

---

[API](https://skmtc.dev/primitive/apis/primitive-api.md) · [All operations](https://skmtc.dev/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primitive/primitive-api/revisions/c2299d28022c/schema)