Skip to main content
GET
Search invoices
The search endpoint matches a single free-text query against your invoices. Use it when you have a fragment of an invoice number or a buyer’s name and need to find the matching records quickly.
For structured filtering – by buyer, merchant, status, due date, or days past due – use List invoices, which accepts a dedicated query parameter per field and combines them as AND conditions.

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

query
string
default:""
required
Minimum string length: 1
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:

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