Skip to main content
GET
List invoices
This endpoint returns all invoices associated with your platform in reverse chronological order. Results are paginated using offset-based pagination, giving you precise control over page size and position within the full dataset. Use this endpoint for reconciliation workflows, building administrative dashboards, or auditing financing activity across all buyers and merchants on your platform.
To page through all invoices, continue requesting with an incremented offset until the number of items returned is less than limit, or until offset is greater than or equal to total.
For a complete bulk export without pagination, use the Export invoices CSV endpoint, which returns all matching invoices in a single streaming response.

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

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.

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:
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 invoices.

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