# Summen- und Saldenliste als PDF oder CSV (https://developer.bimetrics.de/reference/accounting/download-trial-balance)

`GET https://app.bimetrics.de/api/accounting/balances/report`

operationId: `downloadTrialBalance` · Berechtigung (Scope): `read` · Bereich: Buchhaltung

Liefert die Summen- und Saldenliste mit denselben Werten wie `GET /api/accounting/balances` als Datei für die Kanzlei. Das PDF listet die Sachkonten nach Kontenklasse mit einer Summe je Klasse, dann Debitoren und Kreditoren mit ihrer Summe, das Ergebnis der Vorjahre in einer eigenen Zeile und die Gesamtsumme, darunter Hinweise, was die Liste zählt. Die CSV-Datei hat eine Zeile je Konto, das Ergebnis der Vorjahre steht zuletzt ohne Konto. Ein anderes Format ergibt `400`.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `from` | query | ja | string | Erster Tag des Zeitraums, `YYYY-MM-DD`. |
| `to` | query | ja | string | Letzter Tag des Zeitraums, `YYYY-MM-DD`, im selben Kalenderjahr wie `from`. |
| `format` | query | ja | string | `pdf` oder `csv`. In der CSV-Datei sind die Beträge Zahlen ohne Vorzeichen mit Dezimalkomma, die Seite von EB-Wert und Saldo (`S` oder `H`) steht in eigenen Spalten. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/accounting/balances/report" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Die Summen- und Saldenliste als PDF oder, mit `format=csv`, als CSV-Datei. | `application/pdf`: string (binary) |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diesen Endpunkt (`APIKeyPermissionDenied`, `context.scope` nennt sie; Berechtigungen sind fest: neuen Schlüssel anlegen, austauschen, alten widerrufen), der Endpunkt ist für API-Schlüssel nicht freigegeben (`APIKeyPermissionDenied` ohne `context.scope`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
