Documentation
Sign inGet started

List delivery attempts

GET
/v1/webhooks/{webhook_id}/attempts
curl -X GET "https://us1.platform.bird.com/v1/webhooks/{webhook_id}/attempts" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=50"
Returns recent delivery attempts recorded for this endpoint, newest first. Bound the window with before / after (timestamps) and cap the page with limit.
Parámetros de consulta
limit
integer
Maximum number of attempts to return. Defaults to 50, capped at 100.
before
string
Only return attempts strictly before this timestamp.
after
string
Only return attempts strictly after this timestamp.
Carga de respuesta
data
array of object
obligatorio
Mostrar atributos secundarios
data.id
string
obligatorio
Unique identifier for this delivery attempt.
data.event_id
nullable string
Bird's source event ID, stable across retries of the same event. Null only for older attempts recorded before event IDs were available.
data.event_type
string
obligatorio
Webhook event type. Open enum — new event types may be added over time, so treat any unrecognized value as a future event rather than an error. The values below are the types known at this version.
data.status
string
obligatorio
Current state of the delivery attempt. pending covers in-flight and sending attempts; failed is reserved for terminal failures.
data.url
string
obligatorio
The endpoint URL the attempt targeted.
data.response_status_code
nullable integer
obligatorio
HTTP status returned by the receiver. Null when no response was received (timeout, connection error, DNS failure).
data.response_body
string
Body returned by your endpoint, truncated when oversized. Empty string when no body was returned.
data.response_duration_ms
integer
obligatorio
Round-trip duration in milliseconds.
data.attempted_at
string
obligatorio
When the delivery attempt was made.