View as markdown
Endpoints · Webhooks

Get all webhooks

GEThttps://api.tickerbot.io/v2/webhooks

Every webhook subscription on this account, newest first.

Query parameters

enum

Filter by status: active or disabled — the only two states a webhook has (disabled covers both a user pause and the automatic disable after repeated delivery failures; consecutive_failures/last_error on each record say which). Omit for all.

activeThe subscription is live and being evaluated.
disabledAuto-suspended after repeated delivery failures, or disabled by you. Re-enable via POST /v2/webhooks/{id}/enable.
integerdefault 50

Page size. Max 100.

string

Opaque cursor from the previous response.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

countnumber

Rows in this page.

next_cursorstring

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

webhooksarray

Your subscriptions, newest first, each with its `subscription_origin` and health fields. `signing_secret` is stripped — it is shown only on create.

Status codes

200
Success — the response shape is documented under Returns above.
400
Invalid ?status value.

Notes

  • Account-scoped, not key-scoped: every key on the same account sees the same registry. Use ?status= to filter and pass next_cursor back via cursor= to paginate.
  • Each row carries a subscription_origin discriminator naming which subscribe endpoint created it — ticker, signal, scan, or event.
  • Every row carries last_error and last_eval_error_at — the answer to "why is my webhook not firing?". last_error is null on a healthy hook; when evaluation or delivery fails it holds the reason, and last_eval_error_at when it last happened. Before 2026-08-11 neither appeared in this sample, so the field a debugging reader most needs was undocumented.
  • signing_secret is omitted in this response — it's only returned on the create call.
  • Visibility is account-wide: every API key on this account sees the same list.
  • Rows carry the same full key set as GET /v2/webhooks/{id} — including rule_id, fields, order, dir, channel, last_predicate_value, last_error, consecutive_failures, and (for event triggers) trigger_kind/event_kinds/event_tickers/event_q. The example above is abridged.