Invoices · List invoices

List invoices

Return a page of an organization's invoices. Results are paginated by page number and can be sorted and filtered by status, search text, and date range.

GET

/api/v1/organizations/{organizationReference}/invoices/posBearer token · X-Client-Id

Authentication and headers

Authenticate with the bearer token from POST /api/v1/organizations/pos/authenticate (see Access token) and send the X-Client-Id header on every request. Define the host once, for example EINV_BASE_URL=https://api.uat.einvoicing.avetiumtechnologies.com/api/v1, and call $EINV_BASE_URL/api/v1/....

Field	Type	Description
X-Client-Id *	string	The organization's client identifier.
Authorization *	string	Bearer <access_token> from POST /api/v1/organizations/pos/authenticate.

Path parameter

Field	Type	Description
organizationReference *	string	Reference of the organization whose invoices you are listing.

Query parameters

Field	Type	Description
page	integer	Zero-based page number. Minimum 0; default 0.
size	integer	Items per page. Minimum 1, maximum 100; default 20.
sortBy	string	Field to sort by; default dateCreated.
sortDir	string	Sort direction; default desc.
status	string	Filter by invoice status. See the status values below.
search	string	Matches invoice number or customer name.
startDate	date	Start of the date range, formatted yyyy-MM-dd (for example 2026-07-01).
endDate	date	End of the date range, formatted yyyy-MM-dd (for example 2026-07-19).

The status filter takes one of these values:

Field	Type	Description
DRAFT	status	Draft invoice.
INPUT_VALIDATED	status	Input validation passed.
INPUT_REJECTED	status	Input validation failed.
NRS_VALIDATED	status	Validated against NRS.
FAILED_NRS_VALIDATION	status	NRS validation failed.
VALIDATED	status	Validated.
SUBMITTED	status	Submitted for approval.
REJECTED	status	Rejected.
NRS_APPROVED	status	Approved by NRS.
NRS_REJECTED	status	Rejected by NRS.

Response

Every response is wrapped in the envelope { statusCode, message, timestamp, data, successful }. For this endpoint, data is a page object:

Field	Type	Description
content	array	Invoice list items for the requested page.
number	integer	Zero-based index of this page.
size	integer	Requested page size.
numberOfElements	integer	Number of items on this page.
totalElements	integer	Total matching invoices across all pages.
totalPages	integer	Total number of pages.
first	boolean	True on the first page.
last	boolean	True on the last page.
empty	boolean	True when the page has no items.
pageable	object	Paging details: pageNumber, pageSize, offset, paged, unpaged, sort.
sort	object	Sort details: sorted, unsorted, empty.

Invoice list item

Each entry in content is a summary. Retrieve an invoice by id for its full details.

Field	Type	Description
id	string	Invoice ID. Use it to retrieve the invoice.
reference	string	Invoice reference.
invoiceNumber	string	Human-readable invoice number.
title	string	Invoice title.
irn	string	Invoice reference number.
creationSource	enum	WEB, POS, or ERP.
invoiceTemplateId	string	Template used to render the invoice.
dateCreated	date-time	When the invoice was created.
createdBy	string	Creator's identifier.
creatorEmail	string	Creator's email address.
status	enum	Invoice status (see status values).
paymentStatus	enum	PENDING, PAID, or REJECTED.
legalMonetaryTotal	object	{ taxInclusiveAmount }, the invoice total.
customerRecord	object	{ customerName }.

Empty state

A query with no matching invoices still returns 200 with content: [], empty: true, and totalElements: 0.

Empty is not an error

Render an empty state rather than treating zero matches as a failed request.

Pagination guidance

Start at page=0 and request page+1 until last is true

Use totalPages and totalElements to render page controls

Keep filters, sortBy, sortDir, and size unchanged while paging

Restart from page=0 when filters or search change

Request at most 100 items per page

Common errors

Field	Type	Description
400	Bad Request	Invalid query parameters, for example a malformed date.
401	Unauthorized	Bearer token missing, expired, or invalid.
403	Forbidden	The caller may not access this organization's invoices.
404	Not Found	Organization not found.
409	Conflict	The request conflicts with the current state.
500	Internal Server Error	Unexpected server error.

Error bodies use the same envelope with successful: false. See Errors.

Coming soon Soon

Published rate limits and 429 responses with retry guidance are planned. They are not part of the API today.

Retrieve invoice Events