> ## Documentation Index
> Fetch the complete documentation index at: https://docs.business-os.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Balances

> Tägliche Kontosalden (SOD/EOD) mit Transaktionsdetails abrufen.

## Definition

Daily Balances liefern für jeden Tag den **Start of Day (SOD)** und **End of Day (EOD)** Saldo eines Bankkontos, zusammen mit Cash-In, Cash-Out, der Nettoveränderung (Delta) und – wenn `include_transactions=true` gesetzt ist – allen Transaktionen des Tages.

Die Salden werden automatisch bei jedem Connection-Refresh berechnet und gecacht. Die Abfrage kostet keine Credits.

## Berechnung

Die Berechnung erfolgt rückwärts vom aktuellen Kontostand:

* **EOD(heute)** = aktueller Kontostand
* **SOD(heute)** = EOD(heute) - Delta(heute)
* **EOD(gestern)** = SOD(heute)
* usw. für jeden Tag rückwärts

Nur Transaktionen mit `status: "posted"` werden berücksichtigt. Das Datum basiert auf dem `made_on`-Feld der Transaktion.

## List Daily Balances (READ)

Gibt die täglichen Salden für ein Konto zurück, optional gefiltert nach Datumsbereich. Ohne `include_transactions=true` bleibt das Feld `transactions` weg (schnellere Abfrage rein aus dem Cache).

<ResponseExample>
  ```200 - Erfolg theme={null}
  {
    "data": [
      {
        "date": "2026-04-25",
        "sod": 10950.75,
        "eod": 12450.75,
        "cash_in": 1500.00,
        "cash_out": 0,
        "delta": 1500.00,
        "transactions": [
          {
            "id": "6450918273645091827",
            "account_id": "8273645091827364509",
            "duplicated": false,
            "mode": "normal",
            "status": "posted",
            "made_on": "2026-04-25",
            "amount": 1500.00,
            "currency_code": "EUR",
            "description": "Rechnung RE-2026-0042 Beispiel Handels GmbH",
            "description_parsed": {
              "cred": null,
              "mref": null,
              "kref": "NOTPROVIDED",
              "debt": null,
              "svwz": "Rechnung RE-2026-0042",
              "abwa": null,
              "abwe": null,
              "bic": "COBADEFFXXX",
              "oamt": null,
              "coam": null,
              "purp": null
            },
            "category": "uncategorized",
            "extra": {
              "time": "14:32:00",
              "payee": "DE89370400440532013000",
              "payer": "DE02100100100006820101",
              "additional": "SEPA-Überweisung",
              "merchant_id": null,
              "posting_date": "2026-04-25",
              "end_to_end_id": "RE-2026-0042",
              "payee_information": "Mustermann GmbH",
              "payer_information": "Beispiel Handels GmbH",
              "account_balance_snapshot": 12450.75,
              "categorization_confidence": null
            },
            "created_at": "2026-04-25T14:40:14Z",
            "updated_at": "2026-04-25T14:40:14Z"
          }
        ]
      },
      {
        "date": "2026-04-26",
        "sod": 12450.75,
        "eod": 12450.75,
        "cash_in": 0,
        "cash_out": 0,
        "delta": 0,
        "transactions": []
      }
    ]
  }
  ```
</ResponseExample>

## Verbrauch

<Check>
  Für das Ausführen dieses Endpunkts werden **keine Credits** berechnet. Die Daten werden aus dem Cache gelesen.
</Check>