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);
}

attempts = client.webhooks.attempts("whk_01krdgeqcxet5s7t44vh8rt9mg")
for attempt in attempts.data:
    print(attempt.status, attempt.response_status_code)

attempts, err := client.Webhooks.Attempts(context.Background(), "whk_123", bird.WebhooksAttemptsParams{})
if err != nil {
	log.Fatal(err)
}
for _, attempt := range attempts.Data {
	fmt.Println(attempt.Status)
}

$attempts = $bird->webhooks->attempts('whk_01krdgeqcxet5s7t44vh8rt9mg');
foreach ($attempts->getData() ?? [] as $attempt) {
    echo $attempt->getStatus(), PHP_EOL;
}

bird webhooks attempts <webhook-id>

curl -X GET "https://us1.platform.bird.com/v1/webhooks/{webhook_id}/attempts" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=50"

Réponse200

{
  "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.

Paramètres

webhook_idstring

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

Paramètres de requête

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.

Contenu de la réponse

data

array of object

obligatoire

Delivery attempts, newest first.

Afficher les attributs enfants

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.

Essayez la pratique et obtenez un guide d'implémentation

const attempts = await bird.webhooks.attempts(
  "whk_01krdgeqcxet5s7t44vh8rt9mg",
);
for (const attempt of attempts.data) {
  console.log(attempt.status, attempt.response_status_code);
}

attempts = client.webhooks.attempts("whk_01krdgeqcxet5s7t44vh8rt9mg")
for attempt in attempts.data:
    print(attempt.status, attempt.response_status_code)

attempts, err := client.Webhooks.Attempts(context.Background(), "whk_123", bird.WebhooksAttemptsParams{})
if err != nil {
	log.Fatal(err)
}
for _, attempt := range attempts.Data {
	fmt.Println(attempt.Status)
}

$attempts = $bird->webhooks->attempts('whk_01krdgeqcxet5s7t44vh8rt9mg');
foreach ($attempts->getData() ?? [] as $attempt) {
    echo $attempt->getStatus(), PHP_EOL;
}

bird webhooks attempts <webhook-id>

curl -X GET "https://us1.platform.bird.com/v1/webhooks/{webhook_id}/attempts" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=50"

Réponse200

{
  "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"
    }
  ]
}

List delivery attempts

Paramètres

Paramètres de requête

Contenu de la réponse

Ressources associées