---
title: "List delivery history"
method: GET
path: "/v1/webhooks/{id}/deliveries"
tags: ["webhooks"]
---

# List delivery history

`GET /v1/webhooks/{id}/deliveries`

## Request

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

Newest first. Finished deliveries are kept 7 days; pending ones are never purged.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

Recent deliveries.

- WebhookDeliveryList
  - `deliveries` WebhookDelivery[], required
    - `attempts` integer, required
    - `created_at` string, date-time, required
    - `delivered_at` string, date-time, nullable, required
    - `event_type` string, required: message.received, sms.received, domain.verified, or endpoint.test.
    - `id` string, uuid, required: Delivery id — also the envelope's idempotency key and the X-MailFixture-Delivery header.
    - `last_error` string, nullable, required
    - `last_status_code` integer, nullable, required
    - `next_attempt_at` string, date-time, required
    - `status` 'pending' | 'succeeded' | 'failed', required

## Other responses

- `401`: Missing bearer token, malformed key, or unknown/revoked/invalid API key.
- `404`: No such webhook endpoint on this account.
- `429`: Per-key rate limit exceeded. `Retry-After` says when the next request will be admitted; the RateLimit headers name the bucket that refused (`requests` or `creates`) with `r=0`.
- `500`: Unexpected server error. `detail` is null — internals are never leaked.

---

[API](https://skmtc.dev/mailfixture/apis/mailfixture-api.md) · [All operations](https://skmtc.dev/mailfixture/apis/mailfixture-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailfixture/apis/mailfixture-api/revisions/4ddefe29f6f6?raw)