curl --request GET \
--url https://api.tilta.io/v1/buyers/export/csv \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tilta.io/v1/buyers/export/csv', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/buyers/export/csv"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/buyers/export/csv",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}"<string>"{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Export buyers
Download all buyers on your platform as a CSV file. Returns a complete, unpaginated export of buyer records – ideal for reporting and bulk data sync.
curl --request GET \
--url https://api.tilta.io/v1/buyers/export/csv \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tilta.io/v1/buyers/export/csv', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/buyers/export/csv"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/buyers/export/csv",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}"<string>"{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}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.
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.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
Your Tilta API key, sent as Bearer <key>.
Query Parameters
Buyer's IDs to filter in buyers.
"buyer_123,buyer_456"
Buyer's legal name to filter in buyers.
Buyer's trading name to filter in buyers.
Buyer's legal forms to filter in buyers.
"LIMITED_COMPANY,PUBLIC_COMPANY"
Created at range filter (unix timestamps in seconds). Format: "gte..lte" where each bound is optional (e.g. "1580515200..1583020800").
"1580515200..1583020800"
Buyer's billing address countries to filter in buyers.
"DE,AT"
Buyer's billing address city to filter in buyers.
Buyer's billing address street to filter in buyers.
Buyer's billing address postcode to filter in buyers.
Buyer's delivery address countries to filter in buyers.
"DE,AT"
Buyer's delivery address city to filter in buyers.
Buyer's delivery address street to filter in buyers.
Buyer's delivery address postcode to filter in buyers.
Buyer's VAT IDs to filter in buyers.
Maximum days past due range to filter buyers by, in the format gte..lte.
"15..30"
Sort buyers by provided field in ascending or descending order. Prefix field with - for descending order. Example: sort_by=-created_at
Buyer sub-entities to expand in the response object. Currently supported: contacts (buyer contacts).
contacts ["contacts"]
contacts COMMA, SEMICOLON Response
CSV payload streamed as the response body.