Skip to main content

List Webhook Events

GET 
/api/pinnacle/instances/:instance/webhook-events

Paginated audit log of inbound tracking deliveries from MWD. Each delivery is stored exactly as received and processed in the background: status is received (queued), processed, failed (error explains why; failed deliveries are retried automatically for up to 7 days) or duplicate (an identical hourly repeat of an already-processed snapshot).

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Each row carries known_order_ids: a map of tracking number → local Pinnacle order id, for the touched tracking numbers SKU.io has a Pinnacle order for (the UI links only those; any other number has no order to open).

Every filter[<column>] parameter also accepts an operator suffix as filter[<column>.<operator>]=<value>; a bare filter[<column>]=<value> is treated as "is". List operators (is_one_of, is_not_one_of) take a comma-separated list; between takes two comma-separated bounds.

  • Text columns support: contains, does_not_contain, is, is_not, is_one_of, is_not_one_of, starts_with, does_not_start_with, ends_with, does_not_end_with, is_empty, is_not_empty.
  • Numeric columns support: is, is_not, is_one_of, is_not_one_of, greater_than, less_than, greater_than_or_equal, less_than_or_equal, between, is_empty, is_not_empty.
  • Date-time columns support: is, is_not, before, after, on_or_before, on_or_after, between, today, yesterday, tomorrow, past_week, past_month, past_year, next_week, next_month, next_year, days_ago, days_from_now, past_days, next_days, is_empty, is_not_empty. Dates are Y-m-d in the account timezone.

Instead of individual filter[...] params you can send filter_groups: a base64-encoded JSON tree of AND/OR groups, e.g. {"conjunction":"and","children":[{"type":"condition","condition":{"column":"status","operator":"is_one_of","value":["picked_up","at_hub"]}}]}. The same columns and operators are available.

Allowed sorts: id, status, received_at, processed_at, created_at, updated_at. Default sort is -received_at.

per_page defaults to 10.

Authentication: requires a Bearer token (Personal Access Token).

Request​

Responses​

OK

Response Headers
    Content-Type