Webhooks

List webhook delivery log

Changed on

Recent delivery attempts for one webhook destination owned by the authenticated API key user, newest first, with opaque cursor pagination. Returns 404 (identical to an unknown id) when the endpoint is not owned by the caller, so a non-owner cannot tell an owned-but-empty log apart from someone else's endpoint. Delivery rows omit the request body and signing secret. next_attempt_at is when a pending or retry delivery is next attempted; retry_schedule_reason says whether the queue is following receiver_retry_after, transient_failure, permanent_or_auth_failure, manual_redelivery, or configuration_changed; both are null while an attempt is in flight and once the delivery is delivered or dead_letter. A delivery keeps the existing eight-attempt budget, endpoint failure budget, fairness limits, and ordinary 7380-second upper-bound schedule; see POST /api/v1/webhooks for the bounded Retry-After policy. Resend a dead_letter delivery with POST /api/v1/webhooks/{id}/deliveries/{delivery_id}/redeliver.

get/api/v1/webhooks/{id}/deliveries

Request

Path parameters

idinteger required

Webhook endpoint id owned by the authenticated API key user.

Query parameters

cursorstring

Opaque pagination cursor returned as next_cursor by a prior response. Omit to fetch the newest page.

limitinteger

Maximum delivery rows to return per page. Out-of-range values are clamped to 1..100.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Response

Webhook delivery log page

object'list' required
has_moreboolean required
next_cursorstring
totalinteger

Changes

    • warning

      added the new large_trade_inserted_v2 enum value to the // response property for the response status

    • warning

      added the new sharp_money_flow_detected enum value to the // response property for the response status