API Reference
REST API
The XRNotify API is organized around REST. All requests use the base URL https://api.xrnotify.io and return JSON.
Authentication
All requests require your API key in the X-XRNotify-Key header.
curl https://api.xrnotify.io/v1/webhooks \
-H "X-XRNotify-Key: xrn_live_your_key_here"Resources
AuthenticationX-XRNotify-Key
API keys, key types, scopes, rate limits, and error responses.
Webhooks7 endpoints
Create, list, update, delete, and test webhook endpoints. Rotate secrets.
POSTGETPATCHDELETE
Deliveries4 endpoints
Query delivery history, inspect request/response data, retry failed deliveries, view stats.
GETPOST
Events2 endpoints
Browse normalized XRPL events. Filter by type, account, ledger range, or time window.
GET
Replay3 endpoints
Re-deliver past events to a webhook. Create, monitor, and cancel replay jobs.
POSTGETDELETE
All Endpoints
| Method | Path |
|---|---|
| POST | /v1/webhooks |
| GET | /v1/webhooks |
| PATCH | /v1/webhooks/:id |
| DELETE | /v1/webhooks/:id |
| POST | /v1/webhooks/:id/test |
| POST | /v1/webhooks/:id/rotate-secret |
| GET | /v1/deliveries |
| GET | /v1/deliveries/:id |
| POST | /v1/deliveries/:id/retry |
| GET | /v1/deliveries/stats |
| GET | /v1/events |
| GET | /v1/events/:event_id |
| POST | /v1/replay |
| GET | /v1/replay/:job_id |
| DELETE | /v1/replay/:job_id |