---
title: "Delivery history (debugging/support)"
method: GET
path: "/api/v2/webhooks/deliveries"
tags: ["v2 Webhooks"]
---

# Delivery history (debugging/support)

`GET /api/v2/webhooks/deliveries`

## Request

- Base URL: `https://pdf2md.dev`
- URL: `https://pdf2md.dev/api/v2/webhooks/deliveries`
- Auth: one of:
  - API key in cookie `p2m_session`
  - HTTP bearer

EP-023-T10 acceptance: visible delivery history (incl. failed) — status, attempts, response code, error.

## Response `200`

Recent deliveries (newest first)

- object
  - `items` V2WebhookDelivery[]
    - `id` string, uuid
    - `webhook_id` string, uuid, nullable: null = per-job callback
    - `job_id` string, uuid
    - `event` 'job.ready' | 'job.error' | 'job.deleted' | 'job.truncated'
    - `target_url` string, uri
    - `status` 'pending' | 'sending' | 'delivered' | 'failed' | 'exhausted'
    - `attempts` integer
    - `max_attempts` integer: per-tier retry budget
    - `response_code` integer, nullable
    - `last_error` string, nullable
    - `last_attempt_at` string, date-time, nullable
    - `created_at` string, date-time

## Other responses

- `401`: Missing/invalid API key or session

---

[API](https://skmtc.dev/pdf2md/apis/pdf-to-markdown-api-facade.md) · [All operations](https://skmtc.dev/pdf2md/apis/pdf-to-markdown-api-facade/llms.txt) · [OpenAPI document](https://skmtc.dev/pdf2md/apis/pdf-to-markdown-api-facade/revisions/4636782fb8b6?raw)