Skip to main content
GET
Export buyers
The export endpoint streams all buyers associated with your platform as a single CSV file. Unlike the paginated GET /v1/buyers endpoint, this response is not split into pages – every matching buyer is included in one response. This makes it the right tool for bulk reporting, reconciliation workflows, and data syncs with external systems such as a CRM or ERP. The response Content-Type is text/csv and includes a header row with column names.
The limit and offset pagination parameters used by GET /v1/buyers are not supported on this endpoint. All buyers matching your filter criteria are included in the CSV response regardless of volume.
When saving the CSV output with curl, use the --output flag to write the response body directly to a file. Without it, the raw CSV content will print to stdout.

Authorizations

Authorization
string
header
required

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

Query Parameters

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:
expand[]
enum<string>[] | null
Available options:
contacts
delimiter
enum<string>
default:COMMA
Available options:
COMMA,
SEMICOLON

Response

CSV payload streamed as the response body.