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

# List webhook deliveries

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

## Request

- Base URL: `https://earningsfeed.com`
- URL: `https://earningsfeed.com/api/v1/webhooks/{id}/deliveries`
- Auth: HTTP bearer

View delivery history for a specific webhook endpoint. Returns recent deliveries sorted by most recent first.

## Delivery Statuses

| Status | Description |
|--------|-------------|
| **pending** | Delivery queued but not yet sent |
| **delivered** | Successfully delivered (2xx response) |
| **failed** | Delivery failed (non-2xx response or timeout) |

## Debugging Failures

Check `httpStatus` and `errorMessage` fields on failed deliveries. Common issues:
- **Timeout**: Your endpoint must respond within 5 seconds
- **Non-2xx**: Your endpoint returned an error status code
- **Connection refused**: Your URL is unreachable

## Path parameters

- `id` integer, required

## Query parameters

- `limit` integer: Number of items to return (1-100)
- `cursor` string: Cursor for pagination (opaque string from previous response)

## Response `200`

Paginated list of webhook deliveries

- object
  - `deliveries` object[], required
    - `id` number, required
    - `eventType` string, required
    - `status` string, required
    - `httpStatus` number, nullable, required
    - `errorMessage` string, nullable, required
    - `sentAt` string, nullable, required
    - `createdAt` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required

## Other responses

- `401`: Unauthorized - API key required
- `404`: Webhook endpoint not found or not owned by user
- `429`: Minute rate limit or tier monthly quota exceeded. Retry-After points to the relevant minute or monthly reset.
- `500`: Internal server error

---

[API](https://skmtc.dev/earningsfeed/apis/earnings-feed-api.md) · [All operations](https://skmtc.dev/earningsfeed/apis/earnings-feed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earningsfeed/apis/earnings-feed-api/revisions/feefa3647c61?raw)