Skip to main content
GET
List orders
This endpoint returns all orders associated with your platform in reverse chronological order. Results are paginated using offset-based pagination – you control the page size with limit and navigate through pages by incrementing offset. Use this endpoint for administrative dashboards, reconciliation tasks, or bulk exports where you need to enumerate orders across all buyers and merchants.
To retrieve all orders across all pages, increment offset by limit on each request until the number of returned items is less than limit, or until offset exceeds total.
For filtering orders by buyer or other attributes, use the Search orders endpoint instead of paginating through the full list.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Query Parameters

limit
integer
default:100

The number of records to be taken.

Required range: x <= 100
Example:

100

offset
integer
default:0

The number of records to be skipped.

Example:

0

external_id
string

Order's IDs to filter in orders.

Example:

"order_123,order_456"

buyer_external_id
string

Buyer's IDs to filter in orders.

Example:

"buyer_123,buyer_456"

merchant_external_id
string

Merchant's IDs to filter in orders.

Example:

"merchant_123,merchant_456"

status
string

Order statuses to filter in orders.

created_at
string

Created at range filter (unix timestamps in seconds). Format: "gte..lte" where each bound is optional (e.g. "1580515200..1583020800" or "1580515200..").

Example:

"1580515200..1583020800"

ordered_at
string

Ordered at range filter (unix timestamps in seconds). Format: "gte..lte" where each bound is optional (e.g. "1580515200..1583020800").

Example:

"1580515200..1583020800"

amount_gross
string

Gross amount to filter in orders.

Example:

"1000"

currency
string

Currency to filter in orders.

Example:

"EUR,GBP"

sort_by
string

Sort orders by provided field in ascending or descending order. Prefix field with - for descending order. Example: sort_by=-created_at

expand
enum<string>[] | null

Order sub-entities to expand in the response object. Currently supported: buyer (more coming soon).

Available options:
buyer
Example:
custom_data[field]
string

Filter by a Custom Data field. Replace field in custom_data[field] with the field name. Bare values are strings; JSON numbers, booleans, quoted strings, and arrays preserve their JSON types. A scalar also matches an element of a stored array; an array matches a stored array containing all supplied values.

Response

A list of orders.

limit
integer
required

The number of taken records.

Required range: x >= 0
Example:

100

offset
integer
required

The number of skipped records.

Required range: x >= 0
Example:

0

total
integer
required

Total number of records

Required range: x >= 0
Example:

140

items
object[]
required