List Delivery Attempts | Captain Docs

import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
ENDPOINT_ID = "whe_3f9a1c7e5b2d4a6c8e0f1a2b"
MESSAGE_ID = "msg_2mXq8vTn4bK9cR1sZp7Lw3YhJd"
response = requests.get(
    f"{BASE_URL}/v2/webhooks/endpoints/{ENDPOINT_ID}/deliveries/{MESSAGE_ID}/attempts",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=30.0,
)
response.raise_for_status()
data = response.json()
for attempt in data["attempts"]:
    print(
        f"{attempt['timestamp']} {attempt['trigger']}: {attempt['status']} "
        f"(HTTP {attempt['response_status_code']}, {attempt['response_duration_ms']} ms)"
    )

{
  "attempts": [
    {
      "attempt_id": "atmpt_2mXqB7nV3cK8tR1wY5zD9fH2Lj",
      "message_id": "msg_2mXq8vTn4bK9cR1sZp7Lw3YhJd",
      "status": "succeeded",
      "response_status_code": 204,
      "response_duration_ms": 84,
      "trigger": "scheduled",
      "timestamp": "2026-09-23T10:05:18Z"
    },
    {
      "attempt_id": "atmpt_2mXq9sT4wE1rY7uI3oP6aS0dF",
      "message_id": "msg_2mXq8vTn4bK9cR1sZp7Lw3YhJd",
      "status": "failed",
      "response_status_code": 502,
      "response_duration_ms": 1210,
      "trigger": "scheduled",
      "timestamp": "2026-09-23T10:05:13Z"
    }
  ],
  "next_cursor": null
}

List every attempt to deliver one message to one endpoint, with the HTTP status the receiver returned, how long it took, and whether the attempt was an automatic retry (scheduled) or a resend or recovery (manual). The receiver’s response body is not included.

message_id is the delivery’s message_id, or the event’s id (evt_ followed by the job id).

List every attempt to deliver one message to one endpoint, with the HTTP status the receiver returned, how long it took, and whether the attempt was an automatic retry (`scheduled`) or a resend or recovery (`manual`). The receiver's response body is not included. `message_id` is the delivery's `message_id`, or the event's `id` (`evt_` followed by the job id).

Path parameters

endpoint_idstringRequired

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

message_idstringRequired

The delivery’s message_id, or the event’s id (evt_ followed by the job id).

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

attemptslist 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