---
entity: deliveries
namespace: webhook
tag: Webhook Deliveries
description: >
  The latest send of one event to a webhook endpoint, with its attempt count and outcome.
---

# Webhook Deliveries

The latest send of one event to a webhook endpoint, with its attempt count and outcome.

Conventions: /docs/api/v3/conventions.md

## GET /api/v3/webhook/deliveries

Lists the deliveries of one webhook, newest first.

### Description

EXPERIMENTAL — This endpoint is experimental and may change without notice. Field names, request and response shapes, and pagination semantics are not yet stable. Do not depend on this endpoint in production clients.

A delivery is the latest send of one event to the webhook. Its id is the event id, so a resend updates the delivery instead of adding one. The collection is paginated with page[limit] and page[cursor]; send the same filters with every page.

filter[webhook_endpoint_id] is required and is the id of a webhook endpoint.

Optional filters:

* filter[event_type]: workflow-completed, job-completed or ping.
* filter[current_outcome]: succeeded or failed.
* filter[from] and filter[to]: a time range on created_at, within the last 14 days. It defaults to the whole 14 days.

attempt_count includes retries. http_status and duration_ms describe the last attempt.

### Query Parameters

| Name | Type | Required | Description        |
|------|------|----------|--------------------|
| filter[current_outcome] | string | no |  |
| filter[event_type] | string | no |  |
| filter[from] | datetime | no |  |
| filter[to] | datetime | no |  |
| filter[webhook_endpoint_id] | uuid | yes |  |
| page[cursor] | string | no |  |
| page[limit] | int | no |  |

### Response 200

```json
{
  "data": [{
    "id": "uuid",
    "attributes": {
      "event_type": "string",
      "current_outcome": "string",
      "http_status": "int?",
      "attempt_count": "int",
      "duration_ms": "int",
      "created_at": "datetime"
    },
    "references": {
      "webhook_endpoint": {
        "id": "uuid"
      }
    }
  }],
  "page": {
    "next": "string?",
    "prev": "string?"
  }
}
```

### Errors

| Code | Condition                  | Detail                                   |
|------|----------------------------|------------------------------------------|
| 400  | Bad Request                |                                          |
| 404  | Not Found                  |                                          |
| 401  | Invalid or missing token   | Provide a valid Authorization header.    |
| 403  | Insufficient permissions   | You do not have access to this resource. |
| 429  | Rate limit exceeded        | Too many requests. See Retry-After header. |
| 500  | Internal server error      | An unexpected error occurred.            |

## GET /api/v3/webhook/deliveries/:id

Returns the delivery addressed by id.

### Description

EXPERIMENTAL — This endpoint is experimental and may change without notice. Field names, request and response shapes, and pagination semantics are not yet stable. Do not depend on this endpoint in production clients.

id is the id of a delivery from the list, and filter[webhook_endpoint_id] is required and is the id of the webhook endpoint it was sent to. The delivery has the list attributes plus failure_reason, error_type, request_body (the JSON body that was sent) and updated_at, and references the job or workflow the event is about.

failure_reason is set when current_outcome is failed:

* client_error: a 4xx (other than 429), redirect or other non-2xx response.
* rate_limited: a 429 response.
* upstream_error: a 5xx response.
* network: the receiver could not be reached.
* invalid_webhook: the URL resolves to an internal address.
* interrupted: the send did not finish.
* unknown: any other failure.

### Path Parameters

| Name | Type | Required | Description        |
|------|------|----------|--------------------|
| id | uuid | yes | The id. |

### Query Parameters

| Name | Type | Required | Description        |
|------|------|----------|--------------------|
| filter[webhook_endpoint_id] | uuid | yes |  |

### Response 200

```json
{
  "data": {
    "id": "uuid",
    "attributes": {
      "event_type": "string",
      "current_outcome": "string",
      "failure_reason": "string?",
      "http_status": "int?",
      "attempt_count": "int",
      "duration_ms": "int",
      "error_type": "string?",
      "request_body": {

      },
      "created_at": "datetime",
      "updated_at": "datetime"
    },
    "references": {
      "webhook_endpoint": {
        "id": "uuid"
      },
      "job?": {
        "id": "uuid"
      },
      "workflow?": {
        "id": "uuid"
      }
    }
  }
}
```

### Errors

| Code | Condition                  | Detail                                   |
|------|----------------------------|------------------------------------------|
| 400  | Bad Request                |                                          |
| 401  | Invalid or missing token   | Provide a valid Authorization header.    |
| 403  | Insufficient permissions   | You do not have access to this resource. |
| 429  | Rate limit exceeded        | Too many requests. See Retry-After header. |
| 500  | Internal server error      | An unexpected error occurred.            |
| 404  | Entity not found           | The requested deliveries does not exist. |

