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
- object "list"
- data CustomFieldDefinition[]
Beispiel 200
{
"object": "list",
"data": [
{
"object": "custom_field",
"id": "00000000-0000-0000-0000-000000000000",
"key": "…",
"label": "…",
"type": "text",
"options": [
"…"
],
"applies_to": [
"customer"
],
"position": 0
}
]
}