Finance : Invoices

Aangemaakt: 20-07-2026

Omschrijving

Haal de facturen van het account op.

Endpoint

GET https://api.nextname.nl/v2/finance/invoices

URL parameters

Alle parameters zijn optioneel en werken als zoekwaarden om de lijst te filteren. Bekijk voor de volledige syntax van zoekwaarden, operatoren en paginering de pagina Zoekopdrachten.

Parameter	Datatype	Omschrijving
invoice_number	String	Zoekwaarde voor het unieke factuurnummer
status	Array	Zoekwaarde voor de betaalstatus, mogelijke waarden: open en paid
date_invoice	String	Zoekwaarde voor de factuurdatum, formaat: YYYY-MM-DD
date_created	String	Zoekwaarde voor de datum waarop de factuur werd aangemaakt, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone volgens RFC 3339

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Array: data[] met object:
invoice_number	String	Uniek factuurnummer
date_invoice	Date	Factuurdatum (YYYY-MM-DD)
date_created	Datetime	Datum en tijdstip waarop de factuur werd aangemaakt, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone volgens RFC 3339
type	String	Het type document, invoice of credit_invoice
period	Object	De factuurperiode waarop de factuur betrekking heeft: start: startdatum, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone volgens RFC 3339 end: einddatum, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone volgens RFC 3339
auto_collect	Object	Gegevens van de automatische afschrijving. Bij enabled = false bevat het object alleen dat veld; de overige velden zijn dan afwezig: enabled: true als het bedrag automatisch wordt geïncasseerd, anders false method: de incassomethode, bijvoorbeeld direct_debit date_scheduled: de geplande incassodatum (YYYY-MM-DD) status: de status van de incasso, mogelijke waarden: pending, succeeded en failed mandate: object met reference (mandaatkenmerk) en iban (het rekeningnummer waarvan wordt geïncasseerd), alleen wanneer method=direct_debit
status	String	De betaalstatus van de factuur, mogelijke waarden: open en paid
amount	Object	De bedragen van de factuur: currency: valutacode (ISO 4217) subtotal: het bedrag exclusief btw vat: object met amount (het btw-bedrag) en rate (het btw-percentage) total: het totaalbedrag inclusief btw
date_paid	Date	De datum waarop de factuur is betaald (YYYY-MM-DD), of null als de factuur nog openstaat
date_due	Date	De uiterste betaaldatum van de factuur (YYYY-MM-DD)
Object: pagination
current_page	Integer	Huidige pagina
per_page	Integer	Aantal resultaten per pagina
total_pages	Integer	Totaal aantal pagina's
total_results	Integer	Totaal aantal resultaten

Voorbeeld

Beschrijving:
Haal de lijst met facturen van het account op. Het antwoord bevat zowel openstaande (open) als betaalde (paid) facturen, elk met de bijbehorende incasso- en bedraggegevens.

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/invoices";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/finance/invoices

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "data": [
    {
      "invoice_number": "2612345",
      "date_invoice": "2026-07-01",
      "date_created": "2026-07-01T06:23:15Z",
      "type": "invoice",
      "period": {
        "start": "2026-05-31T22:00:00Z",
        "end": "2026-06-30T21:59:59Z"
      },
      "auto_collect": {
        "enabled": true,
        "method": "direct_debit",
        "date_scheduled": "2026-07-17",
        "status": "pending",
        "mandate": {
          "reference": "MDR000056789",
          "iban": "NL00BANK0123456789"
        }
      },
      "status": "open",
      "amount": {
        "currency": "EUR",
        "subtotal": 500.00,
        "vat": {
          "amount": 105.00,
          "rate": 21
        },
        "total": 605.00
      },
      "date_paid": null,
      "date_due": "2026-07-15"
    },
    {
      "invoice_number": "2602345",
      "date_invoice": "2026-06-01",
      "date_created": "2026-06-01T05:48:07Z",
      "type": "invoice",
      "period": {
        "start": "2026-04-30T22:00:00Z",
        "end": "2026-05-31T21:59:59Z"
      },
      "auto_collect": {
        "enabled": false
      },
      "status": "paid",
      "amount": {
        "currency": "EUR",
        "subtotal": 200.00,
        "vat": {
          "amount": 42.00,
          "rate": 21
        },
        "total": 242.00
      },
      "date_paid": "2026-06-11",
      "date_due": "2026-06-15"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 2
  }
}