Belege auflisten
get/api/v1/invoices
Listet alle Belegarten: Rechnungen, Korrekturen (KR-) und Stornos (ST-). Mit type auf eine Art einschränken.
Scope
invoices:read
Parameter
- status query · "draft" | "sent" | "partial" | "paid" | "void"
- type query · "invoice" | "correction" | "cancellation" | "advance_invoice" | "final_invoice"Belegart filtern. Ohne Angabe: alle Arten.
invoiceohne Abschlags- und Schlussrechnungen. - number query · stringExakte Belegnummer (z. B.
RE-2026-0004) — so findet man dieidzu einer Nummer. - custom_fields query · objectFilter nach eigenen Feldern:
custom_fields[schlüssel]=wert, mehrere sind UND-verknüpft. Ja/Nein:trueoderfalse(nicht gesetzt). Unbekannter Schlüssel →400. - limit query · integer
- offset query · integer
curl -X GET "https://maxrechnung.de/api/v1/invoices" \ -H "Authorization: Bearer $MXR_API_KEY"
MXR_API_KEY als Umgebungsvariable setzen. GUI-Clients (Postman, Insomnia, Bruno …): /api/openapi.json importieren.
Antworten
- 200 Liste
- 401 Kein oder ungültiger API-Key
- 403 Scope invoices:read fehlt oder kein Business-Tarif
- 429 Rate Limit überschritten
Schema 200
- object "list"
- data Invoice[]
- limit integer
- offset integer
- has_more boolean
Beispiel 200
{
"object": "list",
"data": [
{
"object": "invoice",
"id": "00000000-0000-0000-0000-000000000000",
"type": "invoice",
"status": "draft",
"number": "RE-2026-004",
"invoice_date": "2026-01-31",
"service_date": "2026-01-31",
"service_date_end": "2026-01-31",
"collected_on": "2026-01-31",
"due_date": "2026-01-31",
"payment_term_days": 14,
"amount_paid": 0,
"amount_open": 428.4,
"corrected_invoice": {
"id": "00000000-0000-0000-0000-000000000000",
"number": "…",
"date": "2026-01-31"
},
"sender": {
"name": "…",
"address": "…",
"tax_id": "…",
"tax_id_kind": "vat_id",
"email": "…",
"bank_name": "…",
"iban": "…"
},
"recipient": {
"name": "…",
"address": "…",
"email": "…",
"vat_id": "…",
"vat_id_check": {
"status": "valid",
"source": "vies",
"checked_at": "2026-01-31T12:00:00Z",
"name": "…",
"stale": false,
"matches": {
"name": "…",
"street": "…",
"postcode": "…",
"city": "…"
}
},
"country": "…",
"contact_name": "…"
},
"delivery": {
"name": "…",
"address": "…",
"country": "DE"
},
"buyer_reference": "…",
"customer_order_number": "…",
"customer_order_date": "2026-01-31",
"customer_id": "00000000-0000-0000-0000-000000000000",
"customer_number": "…",
"supplier_number": "…",
"e_invoice_formats": [
"xrechnung"
],
"vat_scheme": "standard",
"vat_exempt_clause": "8",
"small_business": false,
"price_mode": "net",
"language": "de",
"currency": "EUR",
"exchange_rate": 0,
"discount": {
"type": "percent",
"value": 0,
"reason": "…"
},
"skonto": {
"percent": 0,
"days": 0
},
"line_items": [
{
"description": "…",
"quantity": 3,
"unit": "Std.",
"unit_price": 120,
"vat_rate": 19,
"article_number": "BER-01",
"vat_exempt_clause": "8"
}
],
"notes": "…",
"advances": [
{
"invoice_id": "00000000-0000-0000-0000-000000000000",
"number": "…",
"date": "2026-01-31",
"net": 0,
"vat": 0,
"gross": 0,
"vat_groups": [
{
"rate": null,
"net": null,
"vat": null
}
],
"paid": false
}
],
"totals": {
"lines": 0,
"discount": 0,
"net": 0,
"vat": 0,
"gross": 0,
"service": {
"net": 0,
"vat": 0,
"gross": 0
},
"prepaid": {
"net": 0,
"vat": 0,
"gross": 0
},
"vat_groups": [
{
"rate": 0,
"net": 0,
"vat": 0
}
]
},
"custom_fields": {
"projekt_nr": "P-17",
"stripe_customer_id": "cus_Q1w2e3"
},
"created_at": "2026-01-31T12:00:00Z",
"updated_at": "2026-01-31T12:00:00Z"
}
],
"limit": 0,
"offset": 0,
"has_more": false
}