Positions-Vorlagen auflisten
get/api/v1/item-templates
Gespeicherte Positionen (Beschreibung, Einheit, Menge, Preis, USt.-Satz). Mit customer_id nur die für diesen Kunden sinnvollen: die ihm zugeordneten plus die allgemeinen.
Scope
templates:read
Parameter
- limit query · integer
- offset query · integer
- customer_id query · stringUUID eines Kunden → dessen Vorlagen + allgemeine;
none→ nur allgemeine; leer → alle.
curl -X GET "https://maxrechnung.de/api/v1/item-templates" \ -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 templates:read fehlt
- 422 customer_id ist keine UUID
- 429 Rate Limit überschritten
Schema 200
- object "list"
- data ItemTemplate[]
- limit integer
- offset integer
- has_more boolean
Beispiel 200
{
"object": "list",
"data": [
{
"object": "item_template",
"id": "00000000-0000-0000-0000-000000000000",
"customer_ids": [
"00000000-0000-0000-0000-000000000000"
],
"description": "…",
"unit": "…",
"quantity": 0,
"unit_price": 0,
"price_mode": "net",
"vat_rate": 19,
"article_number": "…",
"archived": false,
"created_at": "2026-01-31T12:00:00Z",
"updated_at": "2026-01-31T12:00:00Z"
}
],
"limit": 0,
"offset": 0,
"has_more": false
}