Sign inGet Started

List delivery attempts

GET
/v1/webhooks/{webhook_id}/attempts
const attempts = await bird.webhooks.attempts(
  "whk_01krdgeqcxet5s7t44vh8rt9mg",
);
for (const attempt of attempts.data) {
  console.log(attempt.status, attempt.response_status_code);
}
Odpowiedź200
{
  "data": [
    {
      "id": "msgatt_3FdaB1NkOmM6m8AxhgEYTJgqHU3",
      "event_id": "whe_01krdgeqcxet5s7t44vh8rt9mg",
      "event_type": "amb.accepted",
      "status": "delivered",
      "url": "https://example.com/webhooks",
      "failure_reason": "The endpoint's connection changed after this delivery was queued.",
      "response_status_code": 200,
      "response_body": "{\"ok\":true}",
      "response_duration_ms": 87,
      "attempted_at": "2026-05-22T11:50:38.080Z"
    }
  ]
}

Returns the endpoint's recent delivery attempts, newest first. Each entry is one HTTP request, so a retried event appears once per try; use it to see what failed and why before requesting redelivery with Replay failed deliveries.

Bound the window with the before/after timestamps and cap the page with limit. To page further back without a cursor, pass the oldest attempted_at you received as before.

Parametry

webhook_idstring

ID of the webhook endpoint (whk_ prefix), as returned when it was created.

Parametry zapytania

limitinteger

Maximum number of attempts to return. Defaults to 50, capped at 100.

beforestring

Only return attempts strictly before this timestamp.

afterstring

Only return attempts strictly after this timestamp.

Treść odpowiedzi

data
array of object
wymagane

Delivery attempts, newest first.

Pokaż atrybuty podrzędne