Get the invoices or sales receipts list

get

https://api.billin.net/v1/invoices

Endpoint to get the invoices and sales receipts list

Important limitation:

Swagger UI does not correctly serialize nested query parameters with brackets when using the “Try it out” feature. As a result, requests built through the Swagger interface may not match the expected format and may return incorrect results.

To use advanced filters reliably, construct the URL manually or use an external HTTP client (Postman, Insomnia, curl, etc.).

The API fully supports bracket-based query syntax; this limitation applies only to Swagger UI presentation, not to the API behavior.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query[documentType]

array of strings

Defaults to INVOICE,CORRECTIVE,TEST_INVOICE

query[documentType]

query[status]

array of strings

Defaults to DRAFT,ISSUED,VOID,CORRECTED,REPLACED

Allowed values:

DRAFT
ISSUED
VOID
CORRECTED: The invoice has been corrected with another invoice (a corrective invoice)
REPLACED: The simplified invoice has been replaced with a standard invoice

query[status]

query[issuedDate]

string

You can filter by a date range using one of the following operators:

$gt: greater than
$gte: greater than or equal
$lt: lower than
$lte: lower than or equal
⚠️ Swagger UI cannot serialize these parameters correctly; build the query manually when using these operators.

Example: query[date][$gt]=2023-01-01&query[date][$lt]=2023-02-01

Accepts ISO-8601 datetime

query[createdAt]

string

You can filter by a date range using one of the following operators:

$gt: greater than
$gte: greater than or equal
$lt: lower than
$lte: lower than or equal
⚠️ Swagger UI cannot serialize these parameters correctly; build the query manually when using these operators.

Example: query[date][$gt]=2023-01-01&query[date][$lt]=2023-02-01

Accepts ISO-8601 datetime

query[updatedAt]

string

You can filter by a date range using one of the following operators:

$gt: greater than
$gte: greater than or equal
$lt: lower than
$lte: lower than or equal
⚠️ Swagger UI cannot serialize these parameters correctly; build the query manually when using these operators.

Example: query[date][$gt]=2023-01-01&query[date][$lt]=2023-02-01

Accepts ISO-8601 datetime

query[serialCode]

string

query[code]

number

query[isPaid]

boolean

query[contact][vatNumber]

string

query[reference]

string

query[getVerifactuInvoices]

boolean

When this parameter is not provided, or is false, only invoices prior to the Verifactu regulation are returned. If true, then only Verifactu type invoices are returned

sort[issuedDate]

string

enum

Allowed:

sort[createdAt]

string

enum

Allowed:

sort[updatedAt]

string

enum

Allowed:

sort[serialCode]

string

enum

Allowed:

sort[code]

string

enum

Allowed:

sort[reference]

string

enum

Allowed:

limit

number

0 to 100

Defaults to 10

offset

number

Responses

200

400

401