Kunden auflisten
get/api/v1/customers
Scope
customers:read
Parameter
- 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/customers" \ -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 customers:read fehlt
- 429 Rate Limit überschritten
Schema 200
- object "list"
- data Customer[]
- limit integer
- offset integer
- has_more boolean
Beispiel 200
{
"object": "list",
"data": [
{
"object": "customer",
"id": "00000000-0000-0000-0000-000000000000",
"name": "…",
"address": "…",
"country": "…",
"customer_number": "…",
"supplier_number": "…",
"contact_name": "…",
"delivery_name": "…",
"delivery_address": "…",
"delivery_country": "…",
"payment_term_days": 0,
"email": "…",
"vat_id": "…",
"buyer_reference": "…",
"vat_scheme": "standard",
"vat_exempt_clause": "8",
"e_invoice_formats": [
"xrechnung"
],
"xrechnung_version": "3.0.2",
"zugferd_profile": "basic",
"price_mode": "net",
"vat_id_check": {
"status": "valid",
"source": "vies",
"checked_at": "2026-01-31T12:00:00Z",
"name": "…",
"stale": false,
"matches": {
"name": "…",
"street": "…",
"postcode": "…",
"city": "…"
}
},
"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
}