---
title: "List webhook deliveries"
method: GET
path: "/webhook_deliveries"
tags: ["Webhooks"]
---

# List webhook deliveries

`GET /webhook_deliveries`

Lists webhook_deliveries for the authenticated user

## Query parameters

- `page` object
  - `number` integer — The page number to load
  - `size` integer — The size of the page
- `filter` object
  - `attempts` object
    - `contains` string — Return only webhook_deliveries whose `attempts` component contains the given text
  - `event_type` string — Return only webhook_deliveries matching the given value of `event_type`. Accepts multiple values separated by a `,`.
  - `finished_at` object
    - `gte` string — Return only webhook_deliveries whose delivery finished later than or at given ISO 8601 datetime
    - `lte` string — Return only webhook_deliveries whose delivery finished earlier than or at given ISO 8601 datetime
  - `started_at` object
    - `gte` string — Return only webhook_deliveries whose delivery started later than or at given ISO 8601 datetime
    - `lte` string — Return only webhook_deliveries whose delivery started earlier than or at given ISO 8601 datetime
  - `status` object
    - `eq` 'delivered' | 'failed' — Return only webhook_deliveries matching the given `status`
  - `webhook` object
    - `contains` string — Return only webhook deliveries whose `webhook` component contains the given text

## Response `200`

A paginated array of webhook_delivery attempts

- object
  - `data` WebhookDelivery[]
    - `attempts` Attempt[] — Detailed delivery attempts, ordered by most recent.
      - `errors` integer[] — Webhook delivery error codes.
      - `finished_at` string, date-time — ISO 8601 timestamp indicating when the attempt has finished.
      - `http` Http — HTTP request and response information.
        - `request` object — Request details.
          - `headers` array[] — List of headers, limited to 10kB.
            - string[]
          - `url` string
        - `response` object — Response details, optional.
          - `body` string — Raw response body, limited to 10kB.
          - `headers` array[] — List of headers, limited to 10kB.
            - string[]
          - `status` integer
      - `started_at` string, date-time — ISO 8601 timestamp indicating when the attempt was initiated.
      - `status` 'delivered' | 'failed'
    - `finished_at` string, date-time — ISO 8601 timestamp indicating when the last webhook response has been received.
    - `id` string, uuid — Uniquely identifies the webhook_delivery record.
    - `record_type` string — Identifies the type of the resource.
    - `started_at` string, date-time — ISO 8601 timestamp indicating when the first request attempt was initiated.
    - `status` 'delivered' | 'failed' — Delivery status: 'delivered' when successfuly delivered or 'failed' if all attempts have failed.
    - `user_id` string, uuid — Uniquely identifies the user that owns the webhook_delivery record.
    - `webhook` object — Original webhook JSON data. Payload fields vary according to event type.
      - `event_type` string — The type of event being delivered.
      - `id` string, uuid — Identifies the type of resource.
      - `occurred_at` string, date-time — ISO 8601 datetime of when the event occurred.
      - `payload` object
      - `record_type` 'event' — Identifies the type of the resource.
  - `meta` PaginationMetaSimple
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable entity

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)