---
title: "List delivery attempts"
method: GET
path: "/v1/webhooks/{webhook_id}/deliveries"
tags: ["Webhooks"]
---

# List delivery attempts

`GET /v1/webhooks/{webhook_id}/deliveries`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/webhooks/{webhook_id}/deliveries`
- Auth: HTTP bearer

Delivery attempt log for the endpoint, newest first. Every attempt
(success, failure, retry) is a separate row. Retained for 30 days.

## Path parameters

- `webhook_id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Delivery attempt log

- object
  - `data` WebhookDelivery[]
    - `event_id` string: Event ID (`evt_...`) — same across retries of one event
    - `event_type` string
    - `url` string: URL the delivery was attempted against
    - `attempt` integer: Attempt number for this event (1-6)
    - `outcome` string: Attempt outcome (e.g. `success`, `failed`)
    - `status_code` integer, nullable: HTTP status your endpoint returned (null if unreachable)
    - `error` string, nullable: Error detail when the attempt failed before an HTTP response
    - `duration_ms` integer, nullable: Round-trip time of the attempt
    - `created` string, date-time: When the attempt was made
  - `pagination` Pagination: Pagination metadata. Cursor-based endpoints (e.g. `/v1/domains`, `/v1/email-users`, `/v1/inbox`, `/v1/email-users/{id}/inbox`) populate `has_more` and `cursor`. Offset-based endpoints (e.g. `/v1/warming`) populate `page`, `per_page`, and `total`. `count` (number of items in the current page) is included where available.
    - `has_more` boolean: Whether more pages exist after this one (cursor-based endpoints).
    - `cursor` string, nullable: Opaque cursor to pass as `?cursor=…` for the next page.
    - `count` integer: Number of items returned in this response.
    - `total` integer: Total number of items across all pages (offset-based endpoints).
    - `page` integer: 1-based page number (offset-based endpoints).
    - `per_page` integer: Items per page (offset-based endpoints).
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `401`: Authentication required or token invalid
- `404`: Resource not found

---

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