List Daily Balances

Gibt tägliche SOD/EOD-Salden für ein Bankkonto zurück, inkl. Cash-In, Cash-Out und Delta. Transaktionen pro Tag werden nur zurückgegeben, wenn include_transactions=true gesetzt ist (ohne Flag bleibt das Feld transactions[] weg — schnelle Abfrage rein aus dem Cache, ohne Banking-Call).

Die Salden werden aus einem Cache gelesen und automatisch bei jedem Refresh aktualisiert.

Cost: Keine Credits

GET /v2/banking/balances

List Daily Balances

cURL

curl --request GET \
  --url https://api.business-os.de/v2/banking/balances \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "date": "2026-04-25",
      "sod": 10000,
      "eod": 10500,
      "cash_in": 1500,
      "cash_out": 1000,
      "delta": 500,
      "transactions": [
        {
          "id": "6450918273645091827",
          "account_id": "8273645091827364509",
          "payment_id": "4509182736450918273",
          "duplicated": false,
          "mode": "normal",
          "status": "posted",
          "made_on": "2026-01-23",
          "amount": -2000,
          "currency_code": "EUR",
          "description": "FOLGELASTSCHRIFT",
          "description_parsed": {
            "cred": "DE02ZZZ00001040743",
            "mref": "21018",
            "kref": null,
            "debt": null,
            "svwz": null,
            "abwa": null,
            "abwe": null,
            "bic": "COBADEFF",
            "oamt": null,
            "coam": null,
            "purp": null
          },
          "category": "service_fee",
          "extra": {
            "time": "00:07:13",
            "payee": "DE93501108006161618027",
            "payer": "DE89370400440532013000",
            "additional": "FOLGELASTSCHRIFT",
            "posting_date": "2026-01-23",
            "end_to_end_id": "XNVR2I7JQ6B6QAT",
            "payee_information": "Pleo Financial Services A/S",
            "payer_information": "MUSTERMANN GMBH",
            "account_balance_snapshot": -5974.36,
            "categorization_confidence": 1
          },
          "created_at": "2026-03-24T13:51:32Z",
          "updated_at": "2026-03-24T13:51:39Z"
        }
      ]
    }
  ]
}

Authorizations

x-api-key · string · header · required

Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.

Query Parameters

account_id · string · required

ID des Bankkontos

from_date · string<date>

Startdatum (YYYY-MM-DD)

to_date · string<date>

Enddatum (YYYY-MM-DD)

include_transactions · boolean · default: false

Wenn true: Transaktionen pro Tag werden im Feld transactions[] mitgeliefert. Default false — nur Salden, deutlich schneller.

Response

200

application/json

Liste der täglichen Salden

data · object[]

Show child attributes