---
title: "List delivery attempts for an endpoint"
method: GET
path: "/v1/webhooks/{id}/deliveries"
tags: ["Webhooks"]
---

# List delivery attempts for an endpoint

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

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/webhooks/{id}/deliveries`
- Auth: HTTP bearer

Inspect delivery history for an endpoint. Filter by `status` (pending, delivering, succeeded, failed_retrying, failed) and/or `subject_id` (the post/video/story this event was about). Last 30 days are retained.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `status` 'pending' | 'delivering' | 'succeeded' | 'failed_retrying' | 'failed': Delivery lifecycle: pending → delivering → (succeeded | failed_retrying → failed).
- `subject_id` string, uuid
- `limit` integer

## Response `200`

Array of delivery records.

- object
  - `success` true, required
  - `data` object, required
    - `deliveries` object[], required
      - `id` string, uuid, required: Delivery UUID — mirrored in the `X-PostQuickAI-Delivery-Id` header. Stable across retries; use for receiver-side dedup.
      - `endpoint_id` string, uuid, required
      - `event` string, required
      - `subject_id` string, uuid, nullable, required
      - `subject_type` string, nullable, required
      - `status` 'pending' | 'delivering' | 'succeeded' | 'failed_retrying' | 'failed', required: Delivery lifecycle: pending → delivering → (succeeded | failed_retrying → failed).
      - `attempt_count` integer, required
      - `next_attempt_at` string, date-time, required
      - `last_http_status` integer, nullable, required
      - `last_response_body` string, nullable, required
      - `last_error` string, nullable, required
      - `created_at` string, date-time, required
      - `delivered_at` string, date-time, nullable, required

---

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