API reference: orders
Read order status and tokens from your own systems.
1 min read
Authentication
Send your API key as a bearer token. Create keys in Settings, then API. Keys are scoped to one store.
curl https://api.cirdan.example/v1/orders/ORD-7H2Q \
-H "Authorization: Bearer $CIRDAN_API_KEY"
Get an order
GET /v1/orders/{token} returns the order status and its history. The address is never returned, in any form, by any endpoint.
{
"token": "ORD-7H2Q",
"status": "delivered",
"items": 2,
"site": "ams-01",
"address": { "state": "deleted", "deleted_at": "2026-09-26T08:00:00Z" }
}
List orders
GET /v1/orders returns orders newest first.
| Parameter | Type | Description |
|---|---|---|
status |
string | Filter by encrypted, shipped, delivered or deleted |
since |
ISO date | Only orders created after this date |
limit |
number | Up to 100, default 25 |
cursor |
string | From next_cursor in the previous response |
Errors
Errors return a JSON body with a code and a readable message. A 404 means the token does not exist in this store. A 410 means the order existed and its data has been deleted.