Documentation Index
Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Every time a filing matches one of your subscriptions, an entry is written to the delivery log
regardless of whether the dispatch succeeded or failed. Use this to debug missed notifications
or verify delivery.
Status values
| Status | Meaning |
|---|
sent | Notification dispatched successfully |
failed | Dispatch attempted but the remote endpoint returned an error |
skipped | Subscription matched but channel was missing a required credential |
List deliveries
GET /v1/notifications/deliveries
| Parameter | Type | Description |
|---|
channel_id | uuid | Filter by a specific channel |
status | string | Filter by status: sent, failed, or skipped |
curl "https://api.ivory.finance/v1/notifications/deliveries" \
-H "X-API-Key: YOUR_API_KEY"
# Only failed deliveries for a specific channel
curl "https://api.ivory.finance/v1/notifications/deliveries?channel_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&status=failed" \
-H "X-API-Key: YOUR_API_KEY"
[
{
"id": 1042,
"subscription_id": "a1b2c3d4-0000-0000-0000-000000000001",
"channel_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"accession_number": "0000320193-26-000010",
"channel_type": "slack",
"status": "sent",
"error_message": null,
"sent_at": "2026-02-24T14:32:11Z"
},
{
"id": 1041,
"subscription_id": "a1b2c3d4-0000-0000-0000-000000000001",
"channel_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"accession_number": "0000789019-26-000042",
"channel_type": "slack",
"status": "failed",
"error_message": "HTTPError: 410 Gone",
"sent_at": "2026-02-24T09:15:04Z"
}
]
