Aug 2026: a breach at Trezor's shipping partner exposed the home addresses of nearly 12,000 customers. Read why →

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.