List orders
The store’s orders, newest first, optionally filtered by status and an inclusive createdAt window. Requires the orders:read scope.
Authorizations
A store API key, sent as Authorization: Bearer <key>.
A key looks like tbrn_live_ followed by 48 hex characters, e.g. tbrn_live_4f2a...c91b. Mint one in the Taberna dashboard under Developers → API Keys, tick the scopes the integration needs, and copy it there and then — the full value is shown once and only its hash is stored, so a lost key is replaced rather than recovered.
One key belongs to one store and carries a fixed scope set. Send it from a server, never from a browser: it can create orders and invoices and read every order the store has.
Query Parameters
Page to return, 1-based.
1
Rows per page, 1–100.
1 <= x <= 10020
Return only orders with this status. Where the order is in its lifecycle. pending — created, waiting for the buyer to pay. completed — paid in full; any digital delivery has been released. partial — funds arrived but fell short of the locked quote. expired — the payment window closed without full payment, and any reserved stock went back to the pool.
pending, completed, partial, expired "pending"
Return only orders created at or after this instant. ISO 8601, with a Z suffix or an explicit offset, e.g. 2026-07-01T00:00:00Z.
"2026-07-01T00:00:00Z"
Return only orders created at or before this instant. ISO 8601, with a Z suffix or an explicit offset, e.g. 2026-07-01T00:00:00Z.
"2026-07-01T00:00:00Z"