List Transactions

Listet Transaktionen auf. Mindestens einer von connection_id oder account_id ist erforderlich — ohne Filter wird 400 zurückgegeben.

• Nur connection_id: alle Konten dieser Connection
• Nur account_id: Connection wird automatisch aufgelöst
• Beide: spezifisches Konto

Der api-Parameter wird automatisch aus der connection_id abgeleitet und muss nicht angegeben werden. Sortierung: made_on aufsteigend.

Cost: 1 Credit per call

GET /v2/banking/transactions

List Transactions

cURL

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

200

{
  "data": [
    {
      "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

connection_id · string

ID der Bank-Verbindung. Mindestens dieser oder account_id muss gesetzt sein.

account_id · string

ID des Bankkontos. Mindestens dieser oder connection_id muss gesetzt sein.

from_date · string<date>

Startdatum (YYYY-MM-DD)

to_date · string<date>

Enddatum (YYYY-MM-DD)

from_id · string

Paginierung/Sync-Cursor: gibt nur Transaktionen mit id strikt größer als dieser zurück (exklusiv, numerisch verglichen). Für laufenden Sync zusammen mit sort=id nutzen — die id ist ingestion-monoton (jede neu eingelesene Transaktion bekommt eine höhere id) und fängt damit auch rückdatierte Nachzügler, die ein Datumsfilter (from_date) verpassen würde.

sort · enum<string> · default: made_on

Sortierung der Rückgabe. made_on (Default): chronologisch nach Wertstellungsdatum (id als Tiebreaker). id: aufsteigend nach Transaktions-ID — empfohlen für inkrementellen Sync mit from_id, weil dann die letzte zurückgegebene id direkt der nächste Cursor ist.

Available options: made_on, id

Response

200

application/json

Liste der Transaktionen

data · object[]

Show child attributes