Export invoices

curl --request GET \
  --url https://api.tilta.io/v1/invoices/export/csv \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.tilta.io/v1/invoices/export/csv', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tilta.io/v1/invoices/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

invoices

export

csv

Export invoices

curl --request GET \
  --url https://api.tilta.io/v1/invoices/export/csv \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.tilta.io/v1/invoices/export/csv', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tilta.io/v1/invoices/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"
}

The CSV export endpoint streams all invoices for your platform in a single response, making it ideal for accounting integrations, financial reconciliation, and bulk data transfers to external systems. Unlike the paginated list endpoint, no limit or offset applies – every invoice matching your filter criteria is included in the export. The response is returned as a downloadable CSV file with a consistent column structure that maps to the invoice object fields.

Use the --output flag in curl to save the response directly to a file. Without it, the raw CSV content is printed to stdout.

On platforms with very large invoice volumes, narrow the export with filters such as invoiced_at, created_at, or status and pull the data in batches rather than requesting the full dataset in one call.

There is no server-side pagination on this endpoint – all matching invoices are included in a single response. For extremely large datasets, the response may take several seconds to stream. Implement appropriate timeout settings on your HTTP client.

Authorizations

Authorization

string

header

required

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

Query Parameters

external_id

string

An array of external_id's to filter invoices by.

Example:

"inv_123,inv_456"

buyer_external_id

string

An array of buyer external_id's to filter invoices by.

Example:

"buyer_123,buyer_456"

merchant_external_id

string

An array of merchant external_id's to filter invoices by.

Example:

"merch_123,merch_456"

invoice_number

string

The invoice number to filter invoices by.

buyer_legal_name

string

Filter invoices by the buyer's legal name. Supports wildcards (e.g. acme, acme*, *acme). Case-insensitive.

Example:

"*acme*"

invoiced_at

string

The invoiced at date range to filter invoices by, in the format gte..lte (unix time in seconds). Each bound is optional.

Example:

"1580515200..1583020800"

amount_gross

string

The gross amount range to filter invoices by.

currency

string

An array of currency codes to filter invoices by.

Example:

"EUR,GBP"

created_at

string

The creation date range to filter invoices by, in the format gte..lte (unix time in seconds). Each bound is optional.

Example:

"1580515200..1583020800"

due_at

string

The due date range to filter invoices by, in the format gte..lte (unix time in seconds). Each bound is optional.

Example:

"1580515200..1583020800"

days_past_due

string

Days past due range to filter invoices by, in the format gte..lte.

Example:

"15..30"

status

string

An array of invoice statuses to filter invoices by.

Example:

"OPEN,DUE,CLOSED,CANCELLED"

financing_status

string

Filter invoices by Financing service status. Comma-separated list of statuses. Use none to include invoices where Financing was never applied.

Example:

"IN_REVIEW,REJECTED,none"

insurance_status

string

Filter invoices by Insurance service status. Comma-separated list of statuses. Use none to include invoices where Insurance was never applied.

Example:

"CLAIM_NOTIFIED,CLAIM_IN_ASSESSMENT"

collection_status

string

Filter invoices by Collection service status. Comma-separated list of statuses. Use none to include invoices where Collection was never applied.

Example:

"EARLY_COLLECTION,LATE_COLLECTION"

sort_by

string

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

expand

enum<string>[] | null

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

Available options:

buyer,

services

Example:

["buyer", "services"]

delimiter

enum<string>

default:COMMA

Available options:

COMMA,

SEMICOLON

Response

CSV payload streamed as the response body.

Buyers

Credit Facilities

Orders

Invoices

Merchants

Contacts & Persons

Webhooks

Platform & Utilities

Export invoices

Authorizations

Query Parameters

Response