---
title: "List webhook deliveries"
method: GET
path: "/api/v1/webhooks/deliveries"
tags: ["webhooks"]
---

# List webhook deliveries

`GET /api/v1/webhooks/deliveries`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/webhooks/deliveries`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/webhooks/deliveries/get.ts> (a function with typed inputs; its response is checked against the schema)

List the verified events providers sent to the environment's endpoints, newest first. Filter by endpoint, status and time range, and page with `page[after]` and `page[before]`.

## Query parameters

- `page[size]` integer
- `page[after]` string
- `page[before]` string
- `filter[endpoint]` string
- `filter[status]` string
- `filter[period]` string
- `filter[from]` string, date-time
- `filter[to]` string, date-time

## Response `200`

Successful request

- ListWebhookDeliveriesResult
  - `data` WebhookDeliveryListItem[], required
    - `id` string, required: The delivery's id.
    - `endpoint` object, nullable, required: The endpoint the delivery arrived on, or `null` if it has since been removed.
      - `id` string, required
      - `declaredId` string, required
    - `status` 'pending' | 'processing' | 'succeeded' | 'failed' | 'filtered' | 'unmatched', required: `pending` is waiting to be routed (including after a retryable error), `processing` is being routed, `succeeded` reached at least one subscriber or waiting run with nothing failed, `failed` means a subscriber failed after its retries, `filtered` means no subscriber's filter took it, and `unmatched` means runs were waiting on the endpoint but none matched and no subscriber took it.
    - `externalDeliveryId` string, required: The provider's id for the delivery, such as a Stripe event id or GitHub's `X-GitHub-Delivery` header.
    - `isTest` boolean, required: Whether the request carried an `x-trigger-test` header, as test sends from the dashboard do.
    - `createdAt` string, date-time, required
    - `processedAt` string, date-time, nullable, required
  - `pagination` object, required
    - `next` string: Pass as `page[after]` to get the next, older page.
    - `previous` string: Pass as `page[before]` to get the previous, newer page.

## Other responses

- `400`: Invalid query parameters, such as an unknown status
- `401`: Unauthorized request

## Changes

- **2026-10-15** `f44b1ec886c8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/webhooks/deliveries/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)