Skip to main content
GET
List invoices

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 invoices with this status. Where the invoice is in its lifecycle. open — issued and payable. paid — settled in full. partial — funds arrived but fell short. expired — the payment window closed unpaid. voided — cancelled by the merchant, no longer payable.

Available options:
open,
paid,
partial,
expired,
voided
Example:

"open"

Response

A page of invoices.

data
object[]
required

The invoices on this page. Newest first.

pagination
object
required

Where this page sits in the full result set.