Skip to main content
GET
List available invoices
searchPhrase performs case-insensitive substring search across invoice number, buyer and seller names and tax identifiers, registration plate, additionalDetails and line product names. Internal debit-note metadata is excluded. An external order reference saved in additionalDetails can help reconcile an ambiguous creation response. The field is not unique: search does not replace an idempotency key or prevent concurrent creation of duplicate invoices. Verify the matching invoice data and paginate the results.

Cleaning up test drafts

Use the existing POST /sales/delete endpoint to remove a draft. There is no DELETE /sales/invoice route.

Authorizations

Authorization
string
header
required

OpenApi Key created within Altera.app for a certain company

Query Parameters

documentsPerPage
enum<string>
default:20

Defines the amount of invoices polled per page

Available options:
10,
20,
50,
100
pageNumber
string

Defines the page we want to poll

sortBy
enum<string>
Available options:
INVOICE_NUMBER,
ISSUE_DATE,
SALE_DATE,
DUE_DATE,
AMOUNT_GROSS,
CONTRACTOR_NAME
Example:

"ISSUE_DATE"

order
enum<string>
Available options:
ASC,
DESC
Example:

"DESC"

searchPhrase
string

Case-insensitive substring search over invoice number, buyer and seller names and tax IDs, registration plate, additionalDetails and invoice line product names. Internal debit-note metadata is excluded. This is free-text search, without external-reference uniqueness or an idempotency guarantee.

contractorName
string
invoiceType
array
Example:

"INTERIM,INTERIM_FINAL"

paymentStatus
enum<string>
Available options:
PAID,
UNPAID,
OVERDUE
Example:

"OVERDUE"

Response

OK

result
string
default:OK
Example:

"OK"

data
object