Documentation · API reference
GET
/api/v1/deliveriesEvery attempt to deliver
This page as Markdown, or in an AI chatMore ways to read this page
Every attempt to deliver, newest first, with its error if it had one.
# Every attempt to deliver
> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-deliveries
`GET /api/v1/deliveries`
Every attempt to deliver, newest first, with its error if it had one.
## The answer
200, `A list of DeliveryView`: One message to one channel: its attempts and its last error (NC-09).
- `attempts` (integer, needed)
- `channel` (string, needed)
- `created_at` (string, needed)
- `done_at` (string or null)
- `error` (string, needed)
- `id` (string, needed)
- `not_before` (string, needed): Not sent before this: quiet hours, or the wait before a retry.
- `state` (string, needed): `pending`, `sent`, `failed` or `dropped`.
- `title` (string, needed)
- `what` (string, needed): `alert`, `recovery` or `test`.
## Asking
```sh
curl https://tidekeeper.eu/api/v1/deliveries \
-H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```
The answer
Status 200
A list of DeliveryView One message to one channel: its attempts and its last error (NC-09).
- attempts
- integerneeded
- channel
- stringneeded
- created_at
- stringneeded
- done_at
- string or null
- error
- stringneeded
- id
- stringneeded
- not_before
- stringneededNot sent before this: quiet hours, or the wait before a retry.
- state
- stringneeded`pending`, `sent`, `failed` or `dropped`.
- title
- stringneeded
- what
- stringneeded`alert`, `recovery` or `test`.
Asking
curl https://tidekeeper.eu/api/v1/deliveries \ -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
const answer = await fetch("https://tidekeeper.eu/api/v1/deliveries", { headers: { Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`, }, }).then((r) => r.json());