List Webhook Events
GET/api/shippo/instances/:integration_instance/webhooks
Paginated log of inbound webhook events received from Shippo. processing_state is processed, failed (error is set) or pending. signature_valid is null when no HMAC secret is configured for the instance. The raw body is returned by Get Raw Webhook Event Payload.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Filtering: every filter[<column>] param below accepts an operator suffix, filter[<column>.<operator>]=<value>; list operators take a comma-separated value. Alternatively pass a nested AND/OR tree in filter_groups (base64-encoded JSON) — see that param.
Sorting: id, event_type, shippo_object_id, tracking_number, received_at, processed_at, attempts, created_at (default -id). Pagination: per_page defaults to 10.
Returns a standard paginated envelope: data[] plus current_page, from, to, per_page, total, last_page, first_page_url, last_page_url, next_page_url, prev_page_url, path and links. Returns 404 for an unknown instance.
Authentication: Requires a Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.