Skip to main content
GET
List orders

Authorizations

Authorization
string
header
required

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
integer
default:1

Page to return, 1-based.

Example:

1

limit
integer
default:20

Rows per page, 1–100.

Required range: 1 <= x <= 100
Example:

20

status
enum<string>

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.

Available options:
pending,
completed,
partial,
expired
Example:

"pending"

createdAfter
string<date-time>

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.

Example:

"2026-07-01T00:00:00Z"

createdBefore
string<date-time>

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.

Example:

"2026-07-01T00:00:00Z"

Response

A page of orders.

data
object[]
required

The orders on this page. Newest first.

pagination
object
required

Where this page sits in the full result set.