List Deliveries

GET

https://api.captain.dev/v2/webhooks/endpoints/:endpoint_id/deliveries

GET

/v2/webhooks/endpoints/:endpoint_id/deliveries

import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
ENDPOINT_ID = "whe_3f9a1c7e5b2d4a6c8e0f1a2b"
response = requests.get(
    f"{BASE_URL}/v2/webhooks/endpoints/{ENDPOINT_ID}/deliveries",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={
        "limit": 25
    },
    timeout=30.0,
)
response.raise_for_status()
data = response.json()
for delivery in data["deliveries"]:
    retry = f", next retry {delivery['next_attempt_at']}" if delivery["next_attempt_at"] else ""
    print(f"{delivery['message_id']} {delivery['event_type']}: {delivery['status']}{retry}")

{
  "deliveries": [
    {
      "message_id": "msg_2mXq8vTn4bK9cR1sZp7Lw3YhJd",
      "event_id": "evt_4f7c2a91-8d3e-4b6a-9f12-7e5d8c0b3a64",
      "event_type": "job.completed_with_errors",
      "status": "succeeded",
      "test": false,
      "created_at": "2026-09-23T10:05:12Z",
      "next_attempt_at": null
    },
    {
      "message_id": "msg_2mXnC4uR8kT1vY6bQ3wE9sZ0Hd",
      "event_id": "evt_9a1e5c3b-2f7d-4e8a-b6c0-1d4f7a2e9b35",
      "event_type": "job.failed",
      "status": "pending",
      "test": false,
      "created_at": "2026-09-23T09:41:57Z",
      "next_attempt_at": "2026-09-23T10:16:57Z"
    }
  ],
  "next_cursor": "eyJpIjoibXNnXzJtWG5DNHVSOGtUMXZZNmJRM3dFOXNaMEhkIn0"
}

List the messages sent, or being sent, to an endpoint, newest first. Each row has the message id (the webhook-id header), the event id (evt_ followed by the job id, null for tests), the event type, the delivery status and when the next retry is due.

Page with cursor until next_cursor is null.

Path parameters

endpoint_idstringRequired

The endpoint's id (whe_...).

Query parameters

limitintegerOptional1-100Defaults to 25

Rows per page (1-100). Defaults to 25.

cursorstring or nullOptional

next_cursor from the previous page.

Response

Successful Response

deliverieslist of objects

next_cursorstring or null

Pass as cursor for the next page. null on the last page.

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

503

Service Unavailable Error