# Summen- und Saldenliste lesen (https://developer.bimetrics.de/reference/accounting/get-trial-balance)

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

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

Liefert die Summen- und Saldenliste (SuSa) wie in DATEV: je bebuchtem Konto den EB-Wert (Saldovortrag), Soll und Haben im Zeitraum, Soll und Haben vom 1. Januar bis zum Ende des Zeitraums und den Saldo. Das Wirtschaftsjahr ist in bimetrics das Kalenderjahr. Liegen `from` und `to` in verschiedenen Jahren oder `from` nach `to`, antwortet die Route mit `400`. Den EB-Wert haben nur Bestandskonten: Er ist der Saldo aller Buchungen vor dem 1. Januar. Erfolgskonten beginnen jedes Jahr bei 0. Weil bimetrics keinen Jahresabschluss bucht, steht das Ergebnis der Erfolgskonten aus den Vorjahren in `previousYearsResultMinor` statt auf einem Konto; mit ihm gehen die EB-Werte auf. Gezählt wird jede Buchung in bimetrics, auch eine noch nicht exportierte. Bestände aus der Zeit vor bimetrics fehlen, solange sie nicht gebucht sind. Automatikkonten stehen netto da, die Steuer auf dem Steuerkonto, auf das DATEV sie für den Steuerschlüssel bucht, etwa 1776 (SKR04 3806). Eine Stornobuchung mindert die Seite der stornierten Buchung, wie die Generalumkehr in DATEV. Anders als DATEV zeigt die SuSa die Umsatzsteuer bei Ist-Versteuerung schon mit der Rechnung statt erst mit der Zahlung, und bei § 13b fehlen die Steuerzeilen, die DATEV über den Steuerschlüssel bildet. Alle Beträge sind in Cent; ein Saldo ist positiv im Soll und negativ im Haben.

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`. |

### Beispiel

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

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: TrialBalance |
| 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 diese Route (`APIKeyPermissionDenied`), 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 |

#### Felder der Antwort 200 (`TrialBalance`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `accounts` | Array<TrialBalanceAccount>, kann null sein | Die bebuchten Konten: Sachkonten nach Nummer, dann Debitoren, dann Kreditoren. |
| `fiscalYearStart` | string | Beginn des Wirtschaftsjahres, in bimetrics der 1. Januar. |
| `from` | string | Erster Tag des Zeitraums, `YYYY-MM-DD`. |
| `previousYearsResultMinor` | integer | Ergebnis der Erfolgskonten vor dem Wirtschaftsjahr, das kein Konto trägt, weil bimetrics keinen Jahresabschluss bucht. In Cent, positiv ein Verlust, negativ ein Gewinn. Mit ihm gehen die EB-Werte auf. |
| `to` | string | Letzter Tag des Zeitraums, `YYYY-MM-DD`. |
| `totals` | TrialBalanceTotal | Summen über alle Konten. |

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