tickerbot.io

List deliveries

GEThttps://api.tickerbot.io/v2/webhooks/{webhook}/deliveries

Lists a webhook's recent deliveries: what was sent and what came back.

stringrequired

Webhook id.

string[]enum

Filter by delivery status (one or a comma list).

pendingQueued or mid-retry; not yet accepted by your target.
deliveredYour target answered 2xx.
permanent_failureGave up: the retry schedule ran out, or the destination refused it for good (a Discord target answered 4xx, or the mobile device is gone). A test fire is never retried.
string

Only deliveries created at or after this moment: YYYY-MM-DD or a UTC timestamp (YYYY-MM-DDTHH:MM:SSZ); a date-only value starts at the beginning of that UTC day. Delivery history is retained for 90 days; deleting a webhook deletes its delivery history with it.

string

Window end (deliveries created up to this moment): same value grammar as from. A date-only value covers that whole UTC day. A timestamp is included until 2027-01-12 and exclusive from then, as everywhere else (Deprecations). from after to is a 400. See Time windows.

integerdefault 50

Page size. Max 100.

string

The previous response's next_cursor. Send it with the same params as the first page (limit may change); a page whose params differ is a 400 naming the param.

as_ofstring

Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).

countnumber

The deliveries in this page.

next_cursorstring

Opaque token for the next page; null on the last page. Pass it back as cursor.

deliveriesarray

Deliveries, newest first. Every row carries every field below; times are epoch seconds.

idstring

The delivery id (dlv_…). Your endpoint receives it in X-Tickerbot-Delivery-Id (a resend sends the original's).

webhook_idstring

The webhook it belongs to.

eventstringenum

What fired.

webhook.firedA ticker, signal or scan webhook: tickers started matching.
events.firedAn event webhook: events landed.
news.firedA news webhook: articles landed.
statusstringenum

Where the delivery stands.

pendingQueued or mid-retry; not yet accepted by your target.
deliveredYour target answered 2xx.
permanent_failureGave up: the retry schedule ran out, or the destination refused it for good (a Discord target answered 4xx, or the mobile device is gone). A test fire is never retried.
attemptnumber

Attempts made so far.

last_status_codenumber

The HTTP status your endpoint returned on the last attempt; null when it could not be reached, before the first attempt, and on in-app deliveries.

last_errorstring

Why the last attempt failed when your endpoint could not be reached (a network error or the 10-second timeout); null when it answered (see last_status_code) or on success. Discord and mobile-push deliveries also describe a rejected request here.

channelstringenum

Where it went.

webhookPOST the payload to an HTTPS endpoint you own, signed with X-Tickerbot-Signature.
discordPost to a Discord channel via its webhook URL. Delivered as a Discord embed, never HMAC-signed: the URL is itself the credential.
in_appDeliver to the in-app feed. No external receiver, so nothing to validate and no test_url.
mobile_pushPush to a registered device. Requires a device_id from Register a device.
target_urlstring

The HTTPS endpoint it was sent to; null on every channel except webhook.

body_stringstring

The exact JSON body, as sent.

created_atnumber

When it was queued (epoch seconds).

delivered_atnumber

When your endpoint accepted it (epoch seconds); null until then.

next_attempt_atnumber

When the next attempt is due, while pending (epoch seconds); null on a failed test fire, which is never retried.

expires_atnumber

When it leaves the 90-day delivery history (epoch seconds); null on rows older than the field.

redelivery_ofstring

On a resend: the original delivery's id; null otherwise.

testboolean

true on a test fire.

CodeMeaning
200Success: the response shape is documented under Returns above.
400Invalid webhook id format, invalid ?status value, a malformed from/to (or from after to), an invalid limit, or a malformed cursor.
404Webhook not found, or owned by another account.
  • Account-scoped: any key on the same account can read any webhook's deliveries.
  • Retries: 30s, 2m, 10m, 1h, 3h, 6h, 12h (8 POSTs, about 22 hours), then the delivery is permanent_failure. When a delivery fails for good after deliveries have kept failing for 72 hours (since failing_since) with none getting through, the webhook is disabled; we email you the first time a delivery fails for good.
  • Resend any delivered or failed delivery (not a test fire; the webhook must be on) with POST /v2/webhooks/{webhook}/deliveries/{delivery}/redeliver.