Invoices

List invoices

GET/invoices

Filterable list of type=invoice documents. Pass status=draft for draft invoices. /draft-invoices is a documented alias of this filter.

Query parameters

statusstring

Invoice status values. Non-exhaustive.

draftpending_reviewapprovedfinalizedsentpaidcancelled

customerIdstring · uuid

issuedAfterstring · date

issuedBeforestring · date

limitinteger · 1–100default 25

cursorstring · uuid

UUID cursor from a previous page's nextCursor.

Responses

200

OK. A page of invoices.

400

Bad request. Malformed request.

401

Unauthorized. Missing, invalid, revoked, or expired API key.

403

Forbidden. The API key lacks a required scope or the creator lacks a required permission.

429

Too many requests. Rate limit exceeded.

Request

curl https://api.neno.build/public/v1/invoices \
  -H "Authorization: Bearer $NENO_API_KEY"

200 OK · application/json

{
  "data": [
    {
      "id": "9b2f6c1e-4a7d-4f0e-8c3b-2d51e7a0f4c9",
      "type": "invoice",
      "status": "draft",
      "invoiceNumber": "2026-0142",
      "language": "en",
      "templateStyle": null,
      "customerName": "Aalto Studio BV",
      "customerContactPerson": "Mira Aalto",
      "customerAddressLine1": "Prinsengracht 263",
      "customerAddressLine2": null,
      "customerCity": "Amsterdam",
      "customerPostalCode": "1016 GV",
      "customerCountryCode": "NL",
      "customerVatNumber": "NL859412763B01",
      "currencyCode": "EUR",
      "netAmountMinor": "125000",
      "taxTotalMinor": "26250",
      "totalMinor": "151250",
      "discountPercent": null,
      "discountMinor": "string",
      "reverseCharge": false,
      "issueDate": "2026-09-24",
      "dueDate": "2026-10-24",
      "paidAt": "2026-09-24T09:30:00Z",
      "poNumber": "PO-88213",
      "notes": null,
      "terms": null,
      "logoUrl": null,
      "lineItems": [
        {
          "lineNo": 1,
          "description": "Brand identity, phase 2",
          "details": null,
          "unit": "project",
          "quantity": "1",
          "unitPriceMinor": "125000",
          "taxRatePercent": "21",
          "discountPercent": null,
          "lineDiscountMinor": "string",
          "lineGrossMinor": "string",
          "lineSubtotalMinor": "string",
          "lineTaxMinor": "string",
          "lineTotalMinor": "string"
        }
      ],
      "taxes": [
        {
          "name": "string",
          "ratePercent": "string",
          "amountMinor": "string",
          "discountMinor": "string"
        }
      ]
    }
  ],
  "nextCursor": null,
  "hasMore": false
}