List webhook delivery attempts

data

• deliveriesobject[]
• deliveries[].idstringrequired
• deliveries[].webhook_idstringrequired
• deliveries[].eventstringrequired

  One of order.created order.paid order.in_production order.shipped order.delivered order.cancelled order.failed order.updated order.rerouted order.quality_check order.issue order.approval_requested order.approval_approved order.approval_declined order.approval_expired campaign.opened campaign.order_added campaign.closed campaign.batch_in_production campaign.completed design.proof_sent design.changes_requested design.approved return.requested return.approved return.remake_created return.resolved return.rejected drop.opened drop.sale drop.closed drop.sold_out checkout_link.sale gift.claimed gift.expired product.updated catalog.synced webhook.disabled autopilot.run.created autopilot.run.awaiting_approval autopilot.run.completed autopilot.run.failed autopilot.run.cancelled design_run.item_ready design_run.completed guarantee.issued guarantee.honored guarantee.breached guarantee.remedied test.ping

• deliveries[].event_idstring | null

  Null only for attempts recorded before the log carried the id.

• deliveries[].status_codeinteger | null
• deliveries[].successbooleanrequired
• deliveries[].failure_causestring | null

  Why a failed attempt failed, and so what to fix: dns, refused, timeout, tls, reset, redirect, unauthorized and the other endpoint-side causes are your URL's; egress, signing and internal are ours, and the attempt is retried on schedule. Null when delivered, and on a failure logged with neither a cause nor a status.

  One of dns unsafe_url refused timeout tls reset network redirect unauthorized http_4xx http_5xx inbox_refused egress signing internal

• deliveries[].created_atstring (date-time)required
• next_cursorstring | null

  The same as meta.next_cursor: send it back as cursor for the next page. Null on the last.

meta

• pageintegerdeprecated

  The page number of the deprecated offset walk, on the lists that published it (orders and an order's events, on every request without cursor; products, on a request that sent page). Absent on a cursor walk, where no page number would be true.

• totalinteger

  Every row matching the request's filters, on the lists that count them (orders, an order's events, assets and products).

• limitinteger

  The page size applied, which is not necessarily the one asked for: a larger limit is clamped. Absent only on a GET /products request without cursor that sent no limit, which answers every match.

• pagesintegerdeprecated

  total over limit, rounded up, beside page (orders and an order's events). Absent on a cursor walk.

• next_cursorstring | nullrequired

  Send it back as cursor for the next page; null exactly when has_more is false. Opaque: pass it back unchanged. Good only on the list that returned it, with a key of the same account and mode (test or live), and with the same filters.

• has_morebooleanrequired

  Whether another page follows this one. Decided from one row past this page, never from a page that came back short — so a page after has_more: true can come back empty only if rows were deleted in between, and the walk still ends at the first has_more: false.

• sincestring | null

  On GET /order/{id}/events only: where to ask from next — the position of the last event in this answer, or, when it has none, the position the request read from. Send it back as since (with wait_seconds to wait for the next event). Unlike next_cursor it is not null at the end of the history; it is null only when the order has no events and the request named no position. Opaque, and bound like a cursor to this order, account and key mode.