Skip to main content
GET
List buyers
This endpoint returns a paginated collection of all buyer records associated with your platform. Use it to build internal dashboards, audit buyer data, or iterate over your buyer base for batch processing. Results are returned in descending order of creation date by default, with the most recently created buyers appearing first. Use the limit and offset parameters to control page size and navigate through large result sets.
To export all buyers without pagination, use Export buyers instead. It streams every matching buyer in a single CSV response.
The total field reflects the count of all buyers on your platform and does not change based on your limit or offset values. Use it to drive pagination controls in your UI.

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

Buyer's IDs to filter in buyers.

Example:

"buyer_123,buyer_456"

Buyer's legal name to filter in buyers.

trading_name
string

Buyer's trading name to filter in buyers.

Buyer's legal forms to filter in buyers.

Example:

"LIMITED_COMPANY,PUBLIC_COMPANY"

created_at
string

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

Example:

"1580515200..1583020800"

business_address_country
string

Buyer's billing address countries to filter in buyers.

Example:

"DE,AT"

business_address_city
string

Buyer's billing address city to filter in buyers.

business_address_street
string

Buyer's billing address street to filter in buyers.

business_address_postcode
string

Buyer's billing address postcode to filter in buyers.

delivery_address_country
string

Buyer's delivery address countries to filter in buyers.

Example:

"DE,AT"

delivery_address_city
string

Buyer's delivery address city to filter in buyers.

delivery_address_street
string

Buyer's delivery address street to filter in buyers.

delivery_address_postcode
string

Buyer's delivery address postcode to filter in buyers.

vat_id
string

Buyer's VAT IDs to filter in buyers.

max_days_past_due
string

Maximum days past due range to filter buyers by, in the format gte..lte.

Example:

"15..30"

sort_by
string

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

expand
enum<string>[] | null

Buyer sub-entities to expand in the response object. Currently supported: contacts (buyer contacts).

Available options:
contacts
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

Buyers for a platform.

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