> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gork.email/llms.txt
> Use this file to discover all available pages before exploring further.

# List Webhook Deliveries

> Inspect recent webhook delivery attempts and endpoint responses for debugging.

Returns recent delivery attempts across your organization's webhook endpoints, newest first. Each row records the event, the attempt number, and what your endpoint answered — everything needed to debug a failing receiver.

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token formatted as `Bearer gork_live_...`. Requires the `webhooks:read` scope.
</ParamField>

### Query parameters

<ParamField query="limit" type="number" default="50">
  Maximum deliveries to return, 1–100.
</ParamField>

<Note>
  Delivery rows embed full event payloads (including email bodies) and your endpoint's response text, so this endpoint is scope-gated like any other read — a least-privilege key cannot dump delivery history.
</Note>

### Response

<ResponseField name="data" type="object[]">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique delivery ID (`del_...`).
    </ResponseField>

    <ResponseField name="webhookId" type="string">
      The endpoint this delivery targeted (`whk_...`).
    </ResponseField>

    <ResponseField name="eventType" type="string">
      The event delivered (e.g. `email.received`).
    </ResponseField>

    <ResponseField name="payload" type="object">
      The full event payload that was sent.
    </ResponseField>

    <ResponseField name="attempt" type="number">
      Which attempt this row records (retries increment it).
    </ResponseField>

    <ResponseField name="responseStatus" type="number">
      HTTP status your endpoint answered with, or `null` when it never responded.
    </ResponseField>

    <ResponseField name="isSuccessful" type="boolean">
      Whether the attempt was accepted.
    </ResponseField>

    <ResponseField name="error" type="string">
      Transport or verification error text, or `null` on success.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 creation timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.gork.email/v1/webhooks/deliveries?limit=20" \
    -H "Authorization: Bearer gork_live_YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Gork } from "@gork/sdk"

  const gork = new Gork({ apiKey: process.env.GORK_API_KEY })

  const deliveries = await gork.webhooks.listDeliveries({ limit: 20 })
  ```

  ```python Python theme={null}
  import requests, os

  res = requests.get(
      "https://api.gork.email/v1/webhooks/deliveries",
      headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
      params={"limit": 20},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "del_1a2b3c4d5e6f",
        "organizationId": "org_1a2b3c4d",
        "webhookId": "whk_1a2b3c4d5e6f",
        "eventType": "email.received",
        "payload": { "messageId": "msg_90e38dfb4a2c" },
        "responseStatus": 200,
        "responseBody": "ok",
        "attempt": 1,
        "isSuccessful": true,
        "error": null,
        "createdAt": "2026-09-11T08:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>