API reference · Orders

List orders

GET/v1/orders

Orders placed with this key, newest first. With updated_since the list switches to sync mode: oldest change first, so you can page forward and never miss an update.

Scope orders:read
600 / minute

Query parameters

limitinteger 1–100: Default 20.
cursorstring: The nextCursor from the previous page.
updated_sinceISO-8601: Sync mode: only orders changed at or after this time, oldest change first. Store the last updatedAt you processed and pass it next time.

Request

curl "https://api.billzova.com/v1/orders?limit=50&updated_since=2026-10-24T00:00:00Z" \
  -H "Authorization: Bearer $BILLZOVA_KEY"

const page = await fetch('https://api.billzova.com/v1/orders?limit=50', {
  headers: { Authorization: `Bearer ${process.env.BILLZOVA_KEY}` },
}).then((r) => r.json());
// page.data, page.nextCursor

Response

200 · application/json

{ "object": "list", "data": [ { "id": "…", "object": "order", "test": false, "…": "…" } ], "hasMore": true, "nextCursor": "0b8e…" }

Errors

Code	HTTP	Meaning
SCOPE_MISSING	403	The key is not allowed to do that.
RATE_LIMITED	429	Too many requests — wait for `Retry-After` seconds.