Invoices

Requires an API key — see Authentication. Read-only (GET).

List invoices

GET /v1/invoices

Query parameters

Parameter	Type	Default	Notes
`limit`	integer	`50`	Max `200`.
`offset`	integer	`0`
`status`	string	—	Exact match (e.g. `paid`, `overdue`). Omit to return invoices in any status.

Results are ordered newest-first by creation date, but note that the creation timestamp itself is not included in the response fields (see below).

Example request

curl -H "Authorization: Bearer lk_YOUR_KEY" \
  "https://tenant.logistall.cloud/api/v1/invoices?status=overdue&limit=2"

Example response

[
  {
    "id": "5d6e7f8a-9b0c-1d2e-3f4a-5b6c7d8e9f0a",
    "invoiceNumber": "INV-00214",
    "status": "overdue",
    "totalAmount": 48250.5,
    "paidAmount": 20000,
    "currencyCode": "MAD",
    "invoiceDate": "2026-06-12T00:00:00.000Z",
    "dueDate": "2026-07-02T00:00:00.000Z"
  },
  {
    "id": "6e7f8a9b-0c1d-2e3f-4a5b-6c7d8e9f0a1b",
    "invoiceNumber": "INV-00198",
    "status": "overdue",
    "totalAmount": 15600,
    "paidAmount": 0,
    "currencyCode": "MAD",
    "invoiceDate": "2026-06-05T00:00:00.000Z",
    "dueDate": "2026-06-25T00:00:00.000Z"
  }
]

status is one of draft, sent, partial, paid, overdue, void, disputed. totalAmount and paidAmount are numbers (not strings), in currencyCode’s currency — base currency across the platform is MAD, though a tenant’s records may use others.

Fields returned

Field	Notes
`id`
`invoiceNumber`
`status`
`totalAmount`	numeric
`paidAmount`	numeric
`currencyCode`
`invoiceDate`
`dueDate`

There is no createdAt field on this endpoint (it’s used only for sort order internally), and no line-item detail — for a full invoice including its line items and PDF, see the Finance page in the User Guide.

Errors

Status	Body	When
`401`	see Authentication	Missing/invalid key.
`500`	`{ "error": "Database error" }`	Unexpected server error.

There is no single-invoice (GET /v1/invoices/:id) endpoint currently — only the list.