Search documents

GET /invoices returns a filtered, paginated collection of your invoices, most recent first. Drafts have their own collection, GET /invoices/draft.

Pagination

• page — page number (default 1)
• itemsPerPage — items per page

Send the header Accept: application/ld+json to get an enriched payload with the Hydra pagination metadata:

• hydra:member — the array of results
• hydra:totalItems — total number of filtered items
• hydra:view — hydra:first, hydra:last, hydra:next, hydra:previous
• hydra:search — description of the available filters

Filters

Query parameter	Effect
status, status[]	filter by lifecycle status (repeat for several)
invoiceNumber	exact invoice number
senderName, senderName[]	issuer name
senderFiscalId, senderFiscalId[]	issuer NIF/NIE/CIF
recipientName, recipientName[]	recipient name
recipientFiscalId, recipientFiscalId[]	recipient NIF/NIE/CIF
downloaded	true / false
`invoiceDate[gt	gte
`createdAt[gt	gte
order[invoiceDate], order[invoiceNumber], order[uuid]	asc / desc

GET /invoices?direction=outgoing&status[]=rejected&status[]=failed&invoiceDate[gte]=2026-01-01&order[invoiceDate]=desc
Authorization: Bearer {{jwt}}
Accept: application/ld+json

See the collection API reference for the full parameter list and response schema.