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

# Banktransaktionen Change Feed API: Hinzugefügt, geändert, entfernt

> Didit liefert über Sync Transactions Änderungen an Transaktionen seit einem Cursor: hinzugefügt, geändert, entfernt.

Der Endpoint Sync Transactions von Didit gibt zurück, was sich seit einem Cursor an den Transaktionen einer Verbindung geändert hat: `added`, `modified` und `removed`.
Ein leerer Cursor gibt alle Transaktionen mit `reset: true` zurück.
Speichern Sie `next_cursor` erst nach einer Antwort mit `has_more: false`.
Siehe [Kontinuierlicher Bank-Feed für die Buchhaltung](https://docs.didit.me/de/use-cases/bank-data-for-accounting.md).


## OpenAPI

````yaml de/openapi-25.json GET /v3/bank/connections/{id}/transactions/sync/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: Identitätsverifizierungs-API. Authentifizierung mit dem x-api-key-Header.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, Verbindungen, Konten, Guthaben, Transaktionen, Institute und
      Abdeckung. Bankdaten sind für Sandbox-Anwendungen verfügbar. Aufrufe einer
      Live-Anwendung antworten mit `404`, bis der Live-Zugriff angekündigt wird.
      In der Sandbox fallen keine Kosten an. Ein Aufruf mit einem API-Schlüssel
      benötigt einen Schlüssel mit der Berechtigung für Bankdaten (`bank-data`):
      Lesezugriff für Lesevorgänge, Schreibzugriff für Operationen, die etwas
      ändern. Die Kontoprüfung ist die Ausnahme: Sie benötigt Schreibzugriff auf
      Sitzungen oder vollen Zugriff, nicht die Berechtigung für Bankdaten.
      Bankdaten sind nicht Teil des vollen Zugriffs: Ein Schlüssel mit vollem
      Zugriff wird abgelehnt, und der Aufruf antwortet mit `403
      bank_data_access_denied`, bis Sie einen Schlüssel mit dieser Berechtigung
      erstellen. Rohe Bankdaten (Konten, Guthaben, Transaktionen und der
      Änderungs-Feed) lehnen außerdem jede Anfrage ab, die keinen API-Schlüssel
      enthält.


      Jede Ablehnung unter `/v3/bank/` außer der der Kontoprüfung hat denselben
      JSON-Body (`code`, `message`, `request_id`, `field`, `next_action`,
      `retry_after`). Ein Pfad, der keine Operation ist, eine ID, die keine UUID
      ist, oder eine unbekannte Unterressource antwortet für jede Methode mit
      `404 not_found`, und jeder unerwartete Fehler antwortet mit `500
      internal_error` und einer `request_id`. Wo Bankdaten nicht verfügbar sind,
      antwortet jede Operation mit dem standardmäßigen `404` der Plattform,
      genau wie bei einer unbekannten Route.
paths:
  /v3/bank/connections/{id}/transactions/sync/:
    get:
      tags:
        - Bank Data
      summary: Transaktionen synchronisieren (Änderungsfeed)
      description: >-
        Gibt zurück, was sich seit einem `cursor` bei den Transaktionen einer
        Verbindung geändert hat: `added`, `modified` und `removed` (mit einem
        `reason`), über alle zugehörigen Konten hinweg. Ein leerer Cursor gibt
        alle aktuellen Transaktionen als `added` zurück und setzt `reset: true`:
        Ersetzen Sie Ihre Kopie damit, anstatt sie zu ergänzen.


        Der erste Abruf ist ein echter Snapshot. Ein erster Abruf (ohne Cursor
        oder der Abruf nach `reset`) gibt jede Transaktion zurück, die die
        Verbindung beim Start des Abrufs hatte, jede genau einmal als `added` in
        ihrem aktuellen Zustand, auch wenn während des Paginierens eine
        Synchronisierung läuft. Änderungen, die während des Paginierens
        vorgenommen werden, kommen im nächsten Abruf ab `next_cursor`: Eine
        Transaktion, die Sie bereits erhalten haben, kommt erneut als
        `modified`, eine neue als `added`. Wenden Sie `modified` als Upsert
        anhand der `id` an und ignorieren Sie eine `removed`-ID, die Sie nicht
        haben. Alle Seiten eines Abrufs spiegeln denselben Zeitpunkt wider.
        Setzen Sie die Paginierung mit `page_token` fort, solange `has_more`
        `true` ist, und speichern Sie `next_cursor` erst nach einer Antwort mit
        `has_more: false`. Schlägt die Paginierung mittendrin fehl, starten Sie
        neu ab dem gespeicherten Cursor.


        Das Änderungsprotokoll ist 90 Tage lang wiederholbar. Ein älterer Cursor
        antwortet mit `410 cursor_expired` und `bootstrap: true`: Beginnen Sie
        erneut mit einem leeren Cursor. Gespeicherter Verlauf läuft nicht ab,
        solange die Verbindung besteht. Eine gebuchte ausstehende Transaktion
        erscheint in `added`, und die ausstehende in `removed` mit `reason:
        pending_booked`. Der Webhook `bank.data.updated` zeigt Ihnen an, wann
        Sie den Endpoint aufrufen sollten.


        Erforderlich ist ein API-Schlüssel mit der Berechtigung Bankdaten
        (`bank-data`): lesen für diesen Vorgang. Ein Schlüssel mit vollem
        Zugriff umfasst sie nicht: Erteilen Sie sie beim Erstellen des
        Schlüssels ausdrücklich, da der Aufruf sonst mit `403
        bank_data_access_denied` antwortet. Eine Sandbox-Anwendung liest ihre
        Test-Bank-Daten allein mit dem Schlüssel. Eine Anfrage ohne
        API-Schlüssel (Client Credentials) wird bei Rohdaten mit demselben `403`
        abgelehnt.
      operationId: syncBankTransactions
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Die Verbindungs-ID.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Der gespeicherte `next_cursor`. Ist er leer oder fehlt er, beginnt
            die Abfrage am Anfang.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 500
          description: Seitengröße, 1 bis 500. Standard 100.
        - name: page_token
          in: query
          required: false
          schema:
            type: string
          description: Setzt dieselbe Abfrage fort, solange `has_more` `true` ist.
      responses:
        '200':
          description: Eine Seite mit Änderungen.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankTransactionChanges'
              examples:
                Changes:
                  summary: >-
                    Eine ausstehende Transaktion wurde gebucht, und eine neue
                    wurde hinzugefügt
                  value:
                    added:
                      - id: 8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963
                        account_id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        status: booked
                        pending_id: null
                        reverses_id: null
                        booking_date: '2026-11-19'
                        value_date: '2026-11-20'
                        transaction_date: null
                        effective_date: '2026-11-19'
                        amount: '-1210.00'
                        currency: EUR
                        direction: debit
                        description: RECIBO SEGURIDAD SOCIAL
                        counterparty:
                          name: ENTIDAD PUBLICA DE EJEMPLO
                          iban: ES0000000000000000005766
                          bic: null
                        remittance:
                          unstructured:
                            - RECIBO SEGURIDAD SOCIAL 10/2026
                          structured: null
                          reference: '0028123456789'
                        bank_transaction_code: PMNT-RDDT-ESDD
                        bank_reference: '2026111900012345'
                        identity_quality: bank_reference
                        end_to_end_id: NOTPROVIDED
                        mandate_id: ES-SS-000123
                        creditor_id: ES00ZZZ00000000
                        merchant_category_code: null
                        exchange: null
                        balance_after: '18250.34'
                        category: taxes_and_social_security
                        first_seen_at: '2026-11-20T06:00:12Z'
                        updated_at: '2026-11-20T06:00:12Z'
                    modified: []
                    removed:
                      - id: e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845
                        reason: pending_booked
                    has_more: false
                    next_page_token: null
                    next_cursor: cur_01HZX9K4M2W7B3T8
                    reset: false
                Bootstrap:
                  summary: Von einem leeren Cursor lesen
                  value:
                    added:
                      - id: 8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963
                        account_id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        status: booked
                        pending_id: null
                        reverses_id: null
                        booking_date: '2026-11-19'
                        value_date: '2026-11-20'
                        transaction_date: null
                        effective_date: '2026-11-19'
                        amount: '-1210.00'
                        currency: EUR
                        direction: debit
                        description: RECIBO SEGURIDAD SOCIAL
                        counterparty:
                          name: ENTIDAD PUBLICA DE EJEMPLO
                          iban: ES0000000000000000005766
                          bic: null
                        remittance:
                          unstructured:
                            - RECIBO SEGURIDAD SOCIAL 10/2026
                          structured: null
                          reference: '0028123456789'
                        bank_transaction_code: PMNT-RDDT-ESDD
                        bank_reference: '2026111900012345'
                        identity_quality: bank_reference
                        end_to_end_id: NOTPROVIDED
                        mandate_id: ES-SS-000123
                        creditor_id: ES00ZZZ00000000
                        merchant_category_code: null
                        exchange: null
                        balance_after: '18250.34'
                        category: taxes_and_social_security
                        first_seen_at: '2026-11-20T06:00:12Z'
                        updated_at: '2026-11-20T06:00:12Z'
                      - id: 2c9e7a05-6b14-4d38-8f2a-b3d51e0c9a67
                        account_id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        status: booked
                        pending_id: null
                        reverses_id: null
                        booking_date: '2026-11-18'
                        value_date: '2026-11-18'
                        transaction_date: null
                        effective_date: '2026-11-18'
                        amount: '3450.00'
                        currency: EUR
                        direction: credit
                        description: TRANSFERENCIA FACTURA 2026-0418
                        counterparty:
                          name: CLIENTE DE EJEMPLO SL
                          iban: ES0000000000000000007891
                          bic: null
                        remittance:
                          unstructured:
                            - FRA 2026-0418
                          structured: null
                          reference: null
                        bank_transaction_code: PMNT-RCDT-ESCT
                        bank_reference: '2026111800009876'
                        identity_quality: bank_reference
                        end_to_end_id: 2026-0418
                        mandate_id: null
                        creditor_id: null
                        merchant_category_code: null
                        exchange: null
                        balance_after: '19460.34'
                        category: income
                        first_seen_at: '2026-11-19T06:00:10Z'
                        updated_at: '2026-11-19T06:00:10Z'
                    modified: []
                    removed: []
                    has_more: false
                    next_page_token: null
                    next_cursor: cur_01HZX9K4M2W7B3T8
                    reset: true
          headers:
            Cache-Control:
              description: '`no-store`.'
              schema:
                type: string
        '400':
          description: >-
            Der Cursor oder das Seitentoken ist ungültig, oder ein Parameter
            liegt außerhalb des gültigen Bereichs. `field` nennt ihn.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Invalid cursor:
                  summary: Ungültiger Cursor
                  value:
                    code: invalid_cursor
                    message: The cursor or page token is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: cursor
                    next_action: null
                    retry_after: null
                Token for another read:
                  summary: Token für einen weiteren Abruf
                  value:
                    code: page_token_mismatch
                    message: >-
                      The page token belongs to a different read. Restart with
                      the same filters.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: page_token
                    next_action: null
                    retry_after: null
                Invalid request:
                  summary: Ungültige Anfrage
                  value:
                    code: invalid_request
                    message: The request is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: limit
                    next_action: null
                    retry_after: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BankDataAccessDenied'
        '404':
          description: Die Ressource existiert in dieser Anwendung und Umgebung nicht.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: Nicht gefunden
                  value:
                    code: not_found
                    message: The resource does not exist.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
        '409':
          description: >-
            Die Verbindung hat keine lesbaren Daten: Sie wurde gelöscht oder
            ihre Aufbewahrungsfrist ist abgelaufen (`connection_not_active`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not active:
                  summary: Nicht aktiv
                  value:
                    code: connection_not_active
                    message: This connection is not active.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: create_link
                    retry_after: null
        '410':
          description: >-
            Der Cursor ist älter als die 90 Tage, für die das Änderungsprotokoll
            gespeichert wird, oder das Seitentoken ist abgelaufen. Bei
            `cursor_expired` enthält der Antworttext `bootstrap: true`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataCursorError'
              examples:
                Cursor expired:
                  summary: Mit einem leeren Cursor neu beginnen
                  value:
                    code: cursor_expired
                    message: >-
                      The cursor is older than the change log. Read again from
                      an empty cursor.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: cursor
                    next_action: restart_from_cursor
                    retry_after: null
                    bootstrap: true
                Page expired:
                  summary: >-
                    Den Lesevorgang ab dem zuletzt gespeicherten Cursor neu
                    starten
                  value:
                    code: page_expired
                    message: The page token expired. Restart the read.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: page_token
                    next_action: restart_read
                    retry_after: null
        '429':
          $ref: '#/components/responses/RateLimitedRead'
        '500':
          $ref: '#/components/responses/BankDataInternalError'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl
            'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/transactions/sync/?cursor=cur_01HZX9K4M2W7B3T8'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.bank.sync_transactions(
                "11111111-2222-3333-4444-555555555555",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.bank.syncTransactions("11111111-2222-3333-4444-555555555555");

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.SyncTransactions(ctx, \"11111111-2222-3333-4444-555555555555\", didit.BankSyncTransactionsParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.bank().syncTransactions("11111111-2222-3333-4444-555555555555");

            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->bank->syncTransactions('11111111-2222-3333-4444-555555555555');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            result =
            didit.bank.sync_transactions("11111111-2222-3333-4444-555555555555")

            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Bank.SyncTransactionsAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    BankTransactionChanges:
      type: object
      description: >-
        Änderungen an den Transaktionen einer Verbindung seit einem Cursor. Ein
        leerer Cursor gibt jede aktuelle Transaktion als `added` zurück. Alle
        Seiten einer Abfrage spiegeln denselben Snapshot wider;
        zwischenzeitliche Änderungen kommen beim nächsten Abruf.
      properties:
        added:
          type: array
          items:
            $ref: '#/components/schemas/BankTransaction'
          description: >-
            Hinzuzufügende Transaktionen. Beim ersten Abruf (ohne Cursor oder
            nach `reset`) sind dies alle Transaktionen, die die Verbindung beim
            Start des Abrufs hatte, jeweils genau einmal und in ihrem aktuellen
            Stand, auch wenn während des Paginierens eine Synchronisierung
            läuft. In späteren Abrufen enthält es die Transaktionen, die seit
            Ihrem Cursor neu sind, sowie die gebuchte Transaktion, die eine
            ausstehende ersetzt.
        modified:
          type: array
          items:
            $ref: '#/components/schemas/BankTransaction'
          description: >-
            Transaktionen, die sich seit Ihrem Cursor geändert haben, in ihrem
            aktuellen Stand. Wenden Sie jede als Upsert anhand von `id` an: Eine
            Transaktion, die Sie bereits beim Paginieren des ersten Abrufs
            erhalten haben, kommt hier erneut, wenn sie sich inzwischen geändert
            hat, und auch eine Korrektur der Bank trifft hier ein.
        removed:
          type: array
          items:
            $ref: '#/components/schemas/BankRemovedTransaction'
          description: >-
            Transaktionen, die nicht mehr existieren, mit einem `reason`.
            Ignorieren Sie eine `id`, die Sie nicht haben: Eine Transaktion, die
            während des Paginierens eines ersten Abrufs entfernt wurde, wurde
            dennoch einmal als `added` ausgeliefert und trifft im nächsten Abruf
            hier ein.
        has_more:
          type: boolean
          description: >-
            `true`, solange weitere Seiten vorhanden sind. Speichern Sie
            `next_cursor` erst nach einer Antwort mit `has_more: false`. Schlägt
            das Paging mittendrin fehl, starten Sie neu ab dem Cursor, den Sie
            zuvor gespeichert hatten.
        next_page_token:
          type: string
          description: Setzt diese Abfrage fort, solange `has_more` `true` ist.
          nullable: true
        next_cursor:
          type: string
          description: >-
            Der dauerhafte Checkpoint des Feeds, der nur auf der letzten Seite
            zurückgegeben wird. Opak und an Anwendung, Umgebung und Verbindung
            gebunden. Für 90 Tage wiederholbar. Beim ersten Lesen markiert er
            den Zeitpunkt, zu dem das Lesen begann, sodass Änderungen, die
            inzwischen erfolgt sind, beim nächsten Lesen ankommen.
          nullable: true
        reset:
          type: boolean
          description: >-
            `true` bei jedem Erstabruf, also bei jedem Abruf mit leerem Cursor:
            Ersetzen Sie Ihre Kopie durch das Ergebnis, statt das Ergebnis daran
            anzuhängen.
      required:
        - added
        - modified
        - removed
        - has_more
        - next_page_token
        - next_cursor
        - reset
    BankDataError:
      type: object
      description: Fehler-Body jeder Bankdaten-Operation. Jedes Feld ist immer vorhanden.
      properties:
        code:
          type: string
          enum:
            - ongoing_access_not_available
            - segment_not_available
            - window_not_available
            - history_window_ambiguous
            - redirect_url_not_registered
            - link_origin_not_allowed
            - bank_data_access_denied
            - connection_not_active
            - consent_expired
            - renewal_not_needed
            - renewal_window_expired
            - access_removed
            - refresh_limit_reached
            - cursor_expired
            - page_expired
            - invalid_cursor
            - page_token_mismatch
            - contract_rate_missing
            - insufficient_credits
            - invalid_request
            - not_found
            - internal_error
          description: >-
            Maschinenlesbarer Fehlercode. Richten Sie Ihre Logik danach aus, nie
            nach `message`.
        message:
          type: string
          description: >-
            Verständliche Erklärung für Entwickler. Der Wortlaut kann sich
            ändern; parsen Sie ihn nicht.
        request_id:
          type: string
          description: >-
            Kennung dieser Anfrage. Geben Sie sie an, wenn Sie den Support
            kontaktieren.
        field:
          type: string
          description: >-
            Das Anfragefeld, das korrigiert werden muss, wenn sich der Fehler
            auf ein einzelnes Feld bezieht. Andernfalls `null`.
          nullable: true
        next_action:
          type: string
          enum:
            - retry_later
            - renew_connection
            - create_link
            - restart_from_cursor
            - restart_read
            - top_up_balance
            - enable_bank_data_access
            - contact_support
            - null
          description: >-
            Was als Nächstes zu tun ist, damit ein Client handeln kann, ohne zu
            raten. `null`, wenn es keinen Standardschritt gibt.
          nullable: true
        retry_after:
          type: integer
          description: >-
            Sekunden, die vor einem Wiederholungsversuch zu warten sind. Wird
            bei Rate-Limit-Fehlern und vorübergehenden Fehlern gesetzt,
            andernfalls `null`.
          nullable: true
      required:
        - code
        - message
        - request_id
        - field
        - next_action
        - retry_after
      example:
        code: ongoing_access_not_available
        message: >-
          This bank cannot keep access open. Use access one_time or choose
          another bank.
        request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
        field: institution_id
        next_action: create_link
        retry_after: null
    BankDataCursorError:
      allOf:
        - $ref: '#/components/schemas/BankDataError'
        - type: object
          properties:
            bootstrap:
              type: boolean
              description: >-
                Wird bei `cursor_expired` gesetzt, immer `true`: Beginnen Sie
                erneut mit einem leeren `cursor` und ersetzen Sie Ihre
                gespeicherte Kopie durch das Ergebnis.
      description: >-
        Inhalt einer `410`-Antwort des Änderungsfeeds. Bei `cursor_expired`
        enthält er `bootstrap: true`: Lesen Sie den Feed mit einem leeren Cursor
        neu ein und ersetzen Sie Ihre Kopie der Transaktionen der Verbindung
        durch dieses Ergebnis, statt sie zu ergänzen. Bei `page_expired` gibt es
        kein `bootstrap`: Starten Sie ab dem zuletzt gespeicherten Cursor neu.
    BankTransaction:
      type: object
      description: >-
        Eine Buchung auf einem Konto. Jedes Feld, das die Bank nicht sendet, ist
        `null`; die Institutsfähigkeiten listen auf, welche Felder eine Bank
        bekanntermaßen sendet.
      properties:
        id:
          type: string
          description: >-
            Didit-ID, undurchsichtig und beim ersten Erkennen gespeichert.
            Dieselbe Bewegung behält ihre ID über Abfragen, Synchronisationen
            und Erneuerungen hinweg. `identity_quality` gibt an, wie stark diese
            Garantie ist.
          format: uuid
        account_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - booked
            - pending
          description: >-
            Eine ausstehende Transaktion hat eine eigene ID. Wenn die Bank sie
            bucht, trägt die gebuchte Transaktion `pending_id`, sofern die Bank
            beide verknüpft, und die ausstehende erscheint in `removed` mit
            `reason: pending_booked`.
        pending_id:
          type: string
          description: >-
            Die ausstehende Transaktion, die diese ersetzt hat. Wird nur
            gesetzt, wenn die Bank sie verknüpft, und wird nie geschätzt.
          format: uuid
          nullable: true
        reverses_id:
          type: string
          description: >-
            Die Transaktion, die diese rückgängig macht, sofern die Bank beide
            verknüpft. Eine Stornierung ist eine neue Transaktion.
          format: uuid
          nullable: true
        booking_date:
          type: string
          format: date
          nullable: true
        value_date:
          type: string
          format: date
          nullable: true
        transaction_date:
          type: string
          format: date
          nullable: true
        effective_date:
          type: string
          description: >-
            Das Datum, das die Datumsfilter verwenden, so wie die Bank es in
            ihrer eigenen Zeitzone meldet, ohne Umrechnung: bei einer gebuchten
            Transaktion ihr Buchungsdatum, sonst ihr Valutadatum, sonst das
            Datum, an dem sie erstmals gesehen wurde; bei einer ausstehenden
            Transaktion ihr Transaktionsdatum, sonst das Datum, an dem sie
            erstmals gesehen wurde.
          format: date
        amount:
          type: string
          description: >-
            Vorzeichenbehafteter Betrag als Dezimalzahl in Zeichenfolgenform.
            Negativ bedeutet Geldabfluss.
          pattern: ^-?\d+(\.\d+)?$
        currency:
          type: string
          pattern: ^[A-Z]{3}$
          description: ISO-4217-Währungscode.
        direction:
          type: string
          enum:
            - credit
            - debit
          description: Wiederholt das Vorzeichen von `amount`.
        description:
          type: string
          nullable: true
        counterparty:
          $ref: '#/components/schemas/BankTransactionCounterparty'
        remittance:
          $ref: '#/components/schemas/BankTransactionRemittance'
        bank_transaction_code:
          type: string
          nullable: true
        bank_reference:
          type: string
          description: >-
            Die unveränderliche Buchungsreferenz der Bank, sofern sie eine
            bereitstellt. Andernfalls `null`, niemals erfunden.
          nullable: true
        identity_quality:
          type: string
          enum:
            - bank_reference
            - route_id
            - derived
          description: >-
            Wie `id` zugeordnet wurde. `bank_reference` und `route_id` sind
            stabil. `derived` wird inhaltlich zugeordnet: Die Zuordnung ist
            stabil, solange die Bank den Eintrag unverändert meldet. Eine
            Korrektur durch die Bank kann dann als ein `removed` und ein `added`
            erscheinen.
        end_to_end_id:
          type: string
          nullable: true
        mandate_id:
          type: string
          nullable: true
        creditor_id:
          type: string
          nullable: true
        merchant_category_code:
          type: string
          nullable: true
        exchange:
          type: object
          nullable: true
          description: Details zum Währungsumtausch, sofern die Bank sie bereitstellt.
          properties:
            source_amount:
              type: string
              pattern: ^-?\d+(\.\d+)?$
              nullable: true
            source_currency:
              type: string
              nullable: true
            rate:
              type: string
              pattern: ^-?\d+(\.\d+)?$
              nullable: true
        balance_after:
          type: string
          description: Guthaben nach der Transaktion, sofern die Bank es angibt.
          pattern: ^-?\d+(\.\d+)?$
          nullable: true
        category:
          type: string
          description: Didit-eigene Kategorie, sofern eine zutrifft.
          nullable: true
        first_seen_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - account_id
        - status
        - pending_id
        - reverses_id
        - booking_date
        - value_date
        - transaction_date
        - effective_date
        - amount
        - currency
        - direction
        - description
        - counterparty
        - remittance
        - bank_transaction_code
        - bank_reference
        - identity_quality
        - end_to_end_id
        - mandate_id
        - creditor_id
        - merchant_category_code
        - exchange
        - balance_after
        - category
        - first_seen_at
        - updated_at
    BankRemovedTransaction:
      type: object
      properties:
        id:
          type: string
          description: Die ID der Transaktion, die nicht mehr aktuell ist.
          format: uuid
        reason:
          type: string
          enum:
            - pending_booked
            - pending_expired
            - bank_removed
            - access_removed
          description: >-
            `pending_booked`: Die Bank hat die Transaktion gebucht, und die
            gebuchte Transaktion steht in `added`. `pending_expired`: Eine
            ausstehende Transaktion, die die Bank nicht mehr meldet.
            `bank_removed`: Die Bank hat sie entfernt. `access_removed`: Das
            Konto ist aus der Einwilligung ausgeschieden.
      required:
        - id
        - reason
    RateLimitBudgetError:
      type: object
      description: >-
        Wird nur bei einer Ablehnung durch das Rate-Limit-Budget der Middleware
        zurückgegeben. Andere 429-Fehler, einschließlich Idempotenzkonflikten
        und endpunktspezifischer Obergrenzen, garantieren diese Metadatenfelder
        nicht.
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: Bestehende, für Menschen lesbare Meldung zur Budgetablehnung.
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: >-
            Opake Support-Referenz: RL- gefolgt von 32 hexadezimalen Zeichen der
            UUID in Kleinbuchstaben.
        limit:
          type: integer
          description: >-
            Budget für den überschrittenen Bereich; entspricht
            X-RateLimit-Limit.
        remaining:
          type: integer
          minimum: 0
          description: >-
            Verbleibendes Budget, auf null begrenzt. Entspricht
            X-RateLimit-Remaining.
        reset:
          type: integer
          format: int64
          description: >-
            Reset-Zeit des Zeitfensters in Unix-Sekunden; entspricht
            X-RateLimit-Reset.
        window_seconds:
          type: integer
          description: >-
            Dauer des festen Zeitfensters in Sekunden, nicht die verbleibende
            Wartezeit. Vor einem erneuten Versuch Retry-After beachten.
      example:
        detail: >-
          Write request rate limit exceeded. You can make up to 300 requests per
          minute.
        reference: RL-00000000000040008000000000000001
        limit: 300
        remaining: 0
        reset: 1794358860
        window_seconds: 60
    BankTransactionCounterparty:
      type: object
      properties:
        name:
          type: string
          nullable: true
        iban:
          type: string
          nullable: true
        bic:
          type: string
          nullable: true
      required:
        - name
        - iban
        - bic
    BankTransactionRemittance:
      type: object
      properties:
        unstructured:
          type: array
          items:
            type: string
        structured:
          type: string
          nullable: true
        reference:
          type: string
          nullable: true
      required:
        - unstructured
        - structured
        - reference
  responses:
    Unauthorized:
      description: Nicht autorisiert
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Ungültiger API-Schlüssel
              value:
                detail: Invalid API Key.
    BankDataAccessDenied:
      description: >-
        Der API-Schlüssel hat nicht die Berechtigung Bank data (`bank-data`).
        Alternativ ist bei Rohdaten der Bank in einer Live-Anwendung die
        Anwendungseinstellung "Bank data in the API" deaktiviert. Bank data ist
        nicht Teil des Vollzugriffs: Ein Schlüssel mit Vollzugriff, ein
        Schlüssel, der auf andere Ressourcen beschränkt ist, und eine Anfrage,
        die ohne API-Schlüssel authentifiziert wurde (Client Credentials, bei
        Rohdaten), werden alle mit diesem Body abgelehnt. Erstellen Sie daher
        einen Schlüssel und gewähren Sie die Berechtigung ausdrücklich. Die
        Ablehnung erfolgt vor jeder Suche und sagt deshalb nichts darüber aus,
        ob ein Objekt existiert.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Bank data not allowed:
              summary: Bankdaten nicht zulässig
              value:
                code: bank_data_access_denied
                message: >-
                  Bank data calls need an API key that carries the Bank data
                  permission.
                request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                field: null
                next_action: enable_bank_data_access
                retry_after: null
    RateLimitedRead:
      description: >-
        Lesebudget der Middleware überschritten. Beachten Sie Retry-After, bevor
        Sie es erneut versuchen.
      headers:
        Retry-After:
          $ref: '#/components/headers/BudgetRetryAfter'
        X-RateLimit-Scope:
          $ref: '#/components/headers/BudgetXRateLimitScope'
        X-RateLimit-Limit:
          $ref: '#/components/headers/BudgetXRateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/BudgetXRateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/BudgetXRateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitBudgetError'
          example:
            detail: >-
              GET request rate limit exceeded. You can make up to 600 requests
              per minute.
            reference: RL-00000000000040008000000000000001
            limit: 600
            remaining: 0
            reset: 1794358860
            window_seconds: 60
    BankDataInternalError:
      description: >-
        Bei Didit ist etwas schiefgelaufen. Jeder unerwartete Fehler unter
        `/v3/bank/` antwortet im Bank-Fehlerformat, niemals mit einer
        HTML-Seite: Geben Sie dem Support die `request_id` an.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: Ein unerwarteter Fehler
              value:
                code: internal_error
                message: >-
                  Something went wrong on our side. Quote the request_id to
                  support.
                request_id: 3f6a1c8e92b54d07a1e38c4b7f0d2e59
                field: null
                next_action: contact_support
                retry_after: null
  headers:
    BudgetRetryAfter:
      description: >-
        Wartezeit in Sekunden, aufgerundet auf das nächste Zeitfenster.
        Vorhanden bei Ablehnungen durch das Middleware-Budget.
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: >-
        Der Geltungsbereich, dessen Budget überschritten wurde. Vorhanden bei
        Ablehnungen durch das Middleware-Budget.
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        Budget für den überschrittenen Bereich; entspricht dem Limit im Body.
        Vorhanden bei Ablehnungen durch das Middleware-Budget.
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        Verbleibendes Budget, auf null begrenzt. Entspricht remaining im Body.
        Bei Ablehnungen durch das Middleware-Budget vorhanden.
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        Reset-Zeit in Unix-Sekunden; entspricht dem Body-Feld reset. Vorhanden
        bei Ablehnungen durch das Middleware-Budget.
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Der API-Schlüssel Ihrer Anwendung, zu finden unter Developers -> API
        keys in der Business Console. Der primäre Schlüssel hat vollen Zugriff.
        Ein benannter Schlüssel kann eingeschränkt werden: pro Ressource keine,
        nur Lese- oder nur Schreibrechte, begrenzt auf einzelne Workflows oder
        nur auf genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein
        Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder
        abgelaufen ist. 403 bedeutet, dass kein Schlüssel gesendet wurde, der
        Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die
        Anfrage von einer Adresse außerhalb seiner IP-Liste kam. 404 bei einer
        Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder
        Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält
        Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne
        Schreibzugriff auf Sitzungen erhält Sitzungslinks und Tokens als null.
        Siehe https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.