Docs
Get an API key
Flight Webhooks

List a subscription's deliveries

GET
/v1/flight/webhook-subscriptions/{id}/deliveries

The subscription's deliveries, newest first, with meta.pagination, each with its event and your endpoint's responses for the current replay. Filter by status to find failed or stuck deliveries.

Authorization

x-api-key<token>

Your API key. Issued and revoked from the TrustPixel dashboard; the gateway resolves it to an owning organization on every request.

In: header

Path Parameters

id*string
Match^whs_[a-zA-Z0-9-]+$
Lengthlength <= 128

Query Parameters

limit?integer
Range1 <= value <= 100
Default25
offset?|
Range0 <= value <= 100000
Default0
status?string

Value in

  • "PENDING"
  • "PUBLISHED"
  • "DELIVERED"
  • "FAILED"

Header Parameters

x-request-id?string

Correlation id echoed to the upstream service and returned on the response. Generated as req_<uuid> when omitted.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/flight/webhook-subscriptions/whs_0192f3a4b5c64d7e8f9a0b1c2d3e4f5b/deliveries"
{  "data": [    {      "id": "dlv_0192f3a4b5c64d7e8f9a0b1c2d3e4f5b",      "status": "PENDING",      "event": {        "id": "string",        "type": "flight.booking.confirmed",        "created_at": "string",        "data": {          "booking": {            "property1": null,            "property2": null          },          "property1": null,          "property2": null        },        "property1": null,        "property2": null      },      "replay_count": 0,      "failure_reason": "retries_exhausted",      "attempts": [        {          "attempt_number": 0,          "response_status": 0,          "response_body": "string",          "created_at": "string"        }      ],      "created_at": "string",      "published_at": "string",      "delivered_at": "string",      "failed_at": "string"    }  ],  "meta": {    "pagination": {      "limit": 20,      "offset": 0,      "has_more": false,      "total": 2    }  }}

Rotate the signing secret POST

Receive a new signing secret, only in this response. For 24 hours new requests carry a signature for each secret. Keep accepting your previous secret for at least 2 hours 15 minutes, because requests queued before the rotation carry only its signature. Rotating again replaces the previous secret.

Replay a delivery POST

Send the same event again with a fresh signature. You can replay a delivered or failed delivery, one pending for more than a minute, or one published more than 2 hours 15 minutes ago without a result; anything else is a `409`, as is a paused subscription. Your endpoint can receive the event again, so ignore repeats by event ID.