Platitun · API · Event subscription · The delivery log

The delivery log

GET /api/v1/hooks/deliveries

Key scope: hooks · read only

Here is the answer to “you never sent it” — “we did”: the event, the time, the attempt count, your receiver’s answer code and the error text. One record per event, not per attempt.

The skipped_paused status marks an event that happened while delivery was paused. It is recorded deliberately: silence would hide from you exactly what you did not receive.

Query filters

Field	Type	What it is
`limit`	`integer`	How many records to return. Default 50, maximum 200.
`cursor`	`string`	The nextCursor value from the previous response. There are no page numbers: the list changes while you page.

Response fields

Field	Type	What it is
`items`	`array`	The records of this page.
`items[].event`	`string`	Which event.
`items[].status`	`string`	pending, delivered, given_up or skipped_paused.
`items[].attempt`	`integer`	Which attempt is running or where it stopped.
`items[].httpStatus`	`integer\|null`	What your receiver answered.
`items[].error`	`string\|null`	What exactly failed.
`items[].nextAttemptAt`	`string\|null`	When the next attempt happens.
`nextCursor`	`string\|null`	The next page cursor. Empty — this is the last page.

Nearby in this section

GET /api/v1/hooks — My event subscription
PUT /api/v1/hooks — Set the address and events
DELETE /api/v1/hooks — Turn delivery off
POST /api/v1/hooks/secret — Rotate the signing secret
POST /api/v1/hooks/resume — Turn delivery back on
POST /api/v1/hooks/test — A test event
POST /api/v1/hooks/probe — Issue a test receiver address
GET /api/v1/hooks/probe — What the test receiver got