Invoices

List credit notes

GET/credit-notes

Lists only type=credit_note documents.

Query parameters

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 credit notes.

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.

200 Response fields

dataarray of objectsrequired

Each item

idstring · uuidrequired

Invoice UUID, distinct from the customer share token.

typestringrequired

invoicecredit_note

creditedInvoiceIdstring · uuid · nullablerequired

createdAtstring · date-timerequired

sentAtstring · date-time · nullablerequired

statusstringrequired

Invoice status values. Non-exhaustive. paid means Neno matched the full payment through bank reconciliation or Mollie. A partial payment remains sent or past_due; no partial-payment status exists. A removed match returns a paid invoice to its unpaid state. scheduled appears for invoices scheduled in the Neno app. Scheduling is not available through this API. Credit notes are issued once finalized and numbered, before they are sent.

draftissuedscheduledsentpast_duepaidcancelled

invoiceNumberstring · nullable

Assigned when the document is finalized.

customerIdstring · uuid · nullable

languagestring · nullable

templateStylestring · nullable

customerNamestringrequired

customerContactPersonstring · nullable

customerAddressLine1string · nullable

customerAddressLine2string · nullable

customerCitystring · nullable

customerPostalCodestring · nullable

customerCountryCodestring · nullable

customerVatNumberstring · nullable

customerEmailstring · nullable

currencyCodestringrequired

netAmountMinorstringrequired

taxTotalMinorstringrequired

totalMinorstringrequired

discountPercentstring · nullable

discountMinorstring

reverseChargeboolean

Reverse charge (BTW verlegd): the customer accounts for the VAT, and the document charges none.

issueDatestring · daterequired

dueDatestring · date · nullable

billingPeriodobject · nullable

payableAccountIdstring · nullable

paidAtstring · date-time · nullable

When Neno recorded a full payment match. It is null while unpaid and can become null if the match is removed.

poNumberstring · nullable

notesstring · nullable

termsstring · nullable

logoUrlstring · nullable

lineItemsarray of objectsrequired

taxesarray of objectsrequired

nextCursorstring · nullable

Cursor for the next page; null when there are no more.

hasMorebooleanrequired

400 Response fields

errorobjectrequired

401 Response fields

errorobjectrequired

403 Response fields

errorobjectrequired

Request

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

200 OK · application/json

{
  "data": [
    {
      "id": "9b2f6c1e-4a7d-4f0e-8c3b-2d51e7a0f4c9",
      "type": "invoice",
      "creditedInvoiceId": "9b2f6c1e-4a7d-4f0e-8c3b-2d51e7a0f4c9",
      "createdAt": "2026-09-24T09:30:00Z",
      "sentAt": "2026-09-24T09:30:00Z",
      "status": "draft",
      "invoiceNumber": "2026-0142",
      "customerId": "9b2f6c1e-4a7d-4f0e-8c3b-2d51e7a0f4c9",
      "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",
      "customerEmail": null,
      "currencyCode": "EUR",
      "netAmountMinor": "125000",
      "taxTotalMinor": "26250",
      "totalMinor": "151250",
      "discountPercent": null,
      "discountMinor": "string",
      "reverseCharge": false,
      "issueDate": "2026-09-24",
      "dueDate": "2026-10-24",
      "billingPeriod": {
        "from": "2026-09-24",
        "to": "2026-09-24"
      },
      "payableAccountId": null,
      "paidAt": "2026-09-24T09:30:00Z",
      "poNumber": "PO-88213",
      "notes": null,
      "terms": null,
      "logoUrl": null,
      "lineItems": [
        {
          "lineNo": 1,
          "name": "string",
          "description": "Brand identity, phase 2",
          "unit": "project",
          "quantity": "1",
          "unitPrice": "string",
          "vatRatePercent": null,
          "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
}