Intent abrufen

Liefert die vollständig aggregierte Sicht auf einen Buchungsvorgang, identifiziert über seine Intent-UUID. Die Antwort enthält alle zugehörigen Journalzeilen inklusive Kontonamen und Beträgen, die komplette Audit-Provenienz (Erstellungszeitpunkt, Urheber als Benutzer oder API-Key-Label, Herkunftskanal wie Dashboard, API, MCP oder Bank-Abgleich) sowie die GoBD-Hash-Kette (audit_hash, prev_hash, journal_number) für die lückenlose Verifikation. Ebenfalls enthalten sind verknüpfte Belege und Banktransaktionen, Storno-Bezüge in beide Richtungen (welches Intent dieser Vorgang storniert und durch welches Intent er selbst storniert wurde) sowie AR/AP-Ausgleichsverknüpfungen (welche offenen Posten hier ausgeglichen werden und welche Zahlungen diesen Vorgang ausgleichen). Damit ist dieser Endpoint der zentrale Einstiegspunkt für Audit-Workflows: Für jedes gebuchte Intent lässt sich lückenlos nachvollziehen, wer wann über welchen Kanal gebucht hat, welche Belege und Banktransaktionen verknüpft sind und ob ein Storno vorliegt.

GET /v1/journal/:intent_id

Authorization

Authorization string header erforderlich API-Key im Format ll_.... Übergabe als Bearer Token.

Antworten

200

Erfolgreich

400

INVALID_INPUT Pflichtfelder fehlen oder Werte entsprechen nicht dem erwarteten Format.

404

NOT_FOUND Die angeforderte Ressource wurde nicht gefunden.

GET /v1/journal/:intent_id

cURL

-cmd">curl --request -method">GET -punct">\
  --url 'https://api.ledgerlou.de/v1/journal/:intent_id' -punct">\
  --header 'Authorization: Bearer ll_your_key'

200 Response

JSON

Vollständiger Audit-View pro Intent: alle Zeilen mit Kontonamen und Provenienz, GoBD-Hash-Kette, verknüpfte Belege und Banktransaktionen, Storno-Bezüge und AR/AP-Ausgleichsverknüpfungen.

{
  "intent_id": "<string>",
  "entries": [
    {
      "id": "<string>",
      "intent_id": "<string>",
      "journal_number": 1,
      "booking_date": "<string>",
      "account_debit": "<string>",
      "account_credit": "<string>",
      "account_debit_name": "<string>",
      "account_credit_name": "<string>",
      "amount": 1,
      "currency": "<string>",
      "description": "<string>",
      "created_at": "<string>",
      "created_by": "<string>",
      "source": "<string>",
      "document_id": "<string>",
      "reverses_intent_id": null,
      "audit_hash": "<string>",
      "prev_hash": "<string>",
      "provenance_summary": {
        "surface": "<string>",
        "surface_label": "<string>",
        "channel": "<string>",
        "channel_label": "<string>",
        "actor_type": "<string>",
        "actor_label": "<string>",
        "actor_key_prefix": "<string>",
        "actor_display": "<string>"
      }
    }
  ],
  "summary": {
    "booking_date": "<string>",
    "description": "<string>",
    "source": "<string>",
    "created_at": "<string>",
    "created_by": "<string>",
    "created_by_label": "<string>",
    "provenance_summary": {
      "surface": "<string>",
      "surface_label": "<string>",
      "channel": "<string>",
      "channel_label": "<string>",
      "actor_type": "<string>",
      "actor_label": "<string>",
      "actor_key_prefix": "<string>",
      "actor_display": "<string>"
    },
    "document_id": "<string>",
    "reverses_intent_id": null,
    "reversed_by_intent_id": null,
    "total_amount": 1,
    "currency": "<string>",
    "journal_number_min": 1,
    "journal_number_max": 1,
    "fx": null,
    "external_reference": null,
    "custom_metadata": null
  },
  "linked_intents": {
    "settles_intent_ids": [],
    "settlement_intent_ids": []
  },
  "metadata": {
    "intent_category": "<string>",
    "confidence": 1,
    "source_type": "<string>",
    "confirmed_at": "<string>",
    "confirmed_by": "<string>",
    "original_description": "<string>",
    "document_id": "<string>",
    "bank_transaction_id": null,
    "is_split_booking": true,
    "total_lines": 1,
    "duplicate_override": true,
    "fx": null,
    "reversal": null,
    "external_reference": null,
    "custom_metadata": null,
    "lines": [
      {
        "line_index": 1,
        "content_hash": "<string>",
        "debit_account": {
          "number": "<string>",
          "name": "<string>"
        },
        "credit_account": {
          "number": "<string>",
          "name": "<string>"
        },
        "fx_amount": null
      }
    ]
  }
}