---
title: "Returns the delivery attempts made to one endpoint, newest first, paginated."
method: GET
path: "/api/webhooks/{uuid}/deliveries"
tags: ["webhooks"]
---

# Returns the delivery attempts made to one endpoint, newest first, paginated.

`GET /api/webhooks/{uuid}/deliveries`

## Request

- Base URL: `https://api.pricklymails.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pricklymails.com/api/webhooks/{uuid}/deliveries`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `uuid` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Paginated delivery history, newest first.

- ListWebhookDeliveriesResponse: `GET /api/webhooks/{uuid}/deliveries` response body.
  - `deliveries` WebhookDeliveryItem[], required: Delivery attempts, newest first.
    - `attempt_number` integer, required: Attempt number, starting at 1.
    - `created_at` string, required: RFC 3339 timestamp of the attempt.
    - `event` string, required: Event that was delivered, for example `"job.completed"`.
    - `is_test` boolean, required: `true` for an attempt made by `POST /api/webhooks/{uuid}/test`.
    - `job_uuid` string, required: UUID of the job the event relates to (all zeros for a test attempt).
    - `response_body` string, nullable: Response body returned by the endpoint, omitted when there was none.
    - `response_status` integer, nullable: HTTP status returned by the endpoint, omitted when the request failed before a response.
  - `limit` integer, required: Page size applied after clamping.
  - `offset` integer, required: Offset applied.

## Other responses

- `400`: Malformed uuid.
- `401`: Missing or invalid API key, session token, or agent token.
- `403`: The key or agent token lacks the `webhooks:read` scope.
- `404`: No endpoint with that uuid owned by the caller.

---

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