Eigene Felder

Die eigenen Felder des Kontos auflisten. Die Werte stehen als custom_fields an Kunden, Rechnungen und Belegen und lassen sich dort setzen und filtern.

Authentifizierung

Jeder Request braucht einen API-Key im Header. Keys entstehen unter Einstellungen → API (nur Business-Tarif). Details zu Scopes, Idempotenz und Rate-Limits auf der Übersichtsseite.

Authorization: Bearer mxr_live_…

Bleibt in diesem Browser-Tab (sessionStorage), nur für „Ausprobieren“ auf dieser Seite, und geht direkt aus deinem Browser an /api/v1 — kein Versand an unseren Server, kein Log.

Eigene Felder auflisten

get/api/v1/custom-fields

Alle eigenen Felder des Kontos in der Reihenfolge der App: Schlüssel, Typ, Auswahlwerte und Bereiche. Angelegt und geändert werden sie in der App unter *Einstellungen → Eigene Felder*. Ohne Blättern (höchstens 50 Felder).

Scope

invoices:read

curl -X GET "https://maxrechnung.de/api/v1/custom-fields" \
  -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 fehlt oder der Tarif reicht nicht (plan_required)
  • 429 Rate Limit überschritten

Schema 200

Beispiel 200

{
  "object": "list",
  "data": [
    {
      "object": "custom_field",
      "id": "00000000-0000-0000-0000-000000000000",
      "key": "…",
      "label": "…",
      "type": "text",
      "options": [
        "…"
      ],
      "applies_to": [
        "customer"
      ],
      "position": 0
    }
  ]
}

Schemas

Von den Endpunkten oben referenzierte Objekte. Vollständig auch in der OpenAPI-Spezifikation.