> ## 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. # AML-Verlauf als CSV exportieren – Didit API > Laden Sie den Verlauf der laufenden AML-Überwachung einer Sitzung als CSV-Datei herunter, eine Zeile pro abgeschlossener Neuprüfung, bereit für den Prüfer. API-Prompt für den Export des AML-Screening-Verlaufs Prompt in die Zwischenablage kopieren 
  \`Download the ongoing AML monitoring history of one Didit verification session as a CSV file through the API.

  Endpoint:
  GET [https://verification.didit.me/v3/session/\{session\_id}/aml-screening-history/export/](https://verification.didit.me/v3/session/\{session_id}/aml-screening-history/export/)

  Authentication:
  Send my Didit API key in the x-api-key header. A scoped key needs decisions: read and media: read (the response is a file; without media: read the call returns 403).

  Goal:

  * Produce the audit evidence that ongoing AML monitoring ran for a subject, as a file a compliance team can hand to an auditor.

  Query parameters:

  * node\_id (optional): the workflow node ID of the AML check when the session ran several AML steps. Without it, the most recent AML check is used.

  Behavior:

  * Works for user (KYC) and business (KYB) session IDs.
  * Streams text/csv with Content-Disposition: attachment; filename="aml-screening-history-SESSION\_ID.csv". Not paginated: the file holds the whole history, newest first.
  * The first line is the header. Each following line is one completed re-screen.
  * Columns: screened\_at, outcome, provider, aml\_status, aml\_score, total\_hits, datasets\_captured\_at, datasets\_sanctions\_last\_updated\_at, datasets\_pep\_last\_updated\_at, datasets\_warnings\_last\_updated\_at, datasets\_adverse\_media\_last\_updated\_at, datasets\_catalog\_version.
  * Empty cell = unknown. Dataset dates are never estimated.
  * provider is an identifier of the data source; treat it as an opaque string.
  * Values that would start a spreadsheet formula (=, +, -, @) are prefixed with an apostrophe.
  * Errors come back as JSON, not CSV.

  Example call:
  curl -X GET "[https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/export/](https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/export/)" \
  -H "x-api-key: YOUR\_API\_KEY" \
  -o aml-screening-history.csv

  Failure modes:

  * 401: the API key has expired.
  * 403: missing key (a wrong, revoked or expired key gets 401), a key of another application, a scoped key without decisions: read or media: read, or a request from outside the key's IP allowlist.
  * 404: the session does not exist, was deleted, or is outside a scoped key's limits, or it has no AML check (for that node\_id).

  Side effects: none. This is a pure read.

  For the full integration shape, see /integration/integration-prompt.\`
Einfügen in Die Datei enthält dieselben Screenings wie [AML-Screening-Verlauf auflisten](https://docs.didit.me/de/management-api/sessions/aml-screening-history.md), jeweils auf eine Zeile reduziert, mit dem Aktualisierungsdatum des Datensatzes für jede Listenfamilie (Sanktionen, PEP, Warnungen, negative Medienberichte), sofern eines gemeldet wurde. Die Business Console bietet denselben Export direkt neben dem AML-Ergebnis an. Was die einzelnen Werte bedeuten, erfahren Sie unter [Laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening.md). ## OpenAPI ````yaml de/openapi-25.json GET /v3/session/{sessionId}/aml-screening-history/export/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/aml-screening-history/export/: get: tags: - Sessions summary: AML-Screening-Verlauf als CSV exportieren description: >- Laden Sie denselben Verlauf der laufenden AML-Überwachung wie bei `GET /v3/session/{sessionId}/aml-screening-history/` als CSV-Datei herunter, eine Zeile pro abgeschlossenem Re-Screening, die neuesten zuerst, bereit zur Übergabe an einen Prüfer. Die Datei wird vollständig gestreamt (keine Paginierung) und beginnt mit einer Kopfzeile; eine leere Zelle bedeutet unbekannt, Datumsangaben im Datensatz werden niemals geschätzt, und ein Wert, der eine Tabellenkalkulationsformel starten würde, wird mit einem Apostroph versehen. Funktioniert für KYC- und KYB-Sitzungs-IDs; übergeben Sie `node_id`, wenn die Sitzung mehr als einen AML-Schritt ausgeführt hat. Übergeben Sie `month`, um einen Kalendermonat zu exportieren. Fehler werden als JSON zurückgegeben, nicht als CSV. Ein eingeschränkter API-Schlüssel benötigt `decisions: read` und `media: read`: Die Antwort ist eine Datei, daher erhält ein Schlüssel ohne `media: read` den Code `403`. operationId: get_v3_session_aml_screening_history_export parameters: - name: sessionId in: path required: true description: >- UUID der Verifizierungssitzung (die von `POST /v3/session/` zurückgegebene `session_id`). Akzeptiert Sitzungs-IDs sowohl für die Benutzerverifizierung (KYC) als auch für die Unternehmensverifizierung (KYB): Der Server löst die ID über beide Sitzungstypen hinweg auf. Muss eine wohlgeformte UUID sein; ein fehlerhafter Wert entspricht nicht der Route und gibt ein HTML-`404` zurück. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- Workflow-Graph-Knoten-ID der AML-Prüfung. Nur erforderlich, wenn die Sitzung mehr als einen AML-Schritt durchlaufen hat; ohne diese Angabe wird die jüngste AML-Prüfung verwendet. Ein unbekannter Knoten gibt `404` zurück. schema: type: string example: feature_aml_1 - name: month in: query required: false description: >- Ein UTC-Kalendermonat im Format `YYYY-MM`. Nur in diesem Monat abgeschlossene Screenings werden zurückgegeben; ohne diese Angabe wird jeder Monat zurückgegeben. Ein fehlerhafter Monat gibt `400` zurück. schema: type: string pattern: ^\d{4}-(0[1-9]|1[0-2])$ example: 2026-09 responses: '200': description: >- Die CSV-Datei, gestreamt als `text/csv` mit CRLF-Zeilenenden. Spalten in dieser Reihenfolge: `screened_at` (wann das erneute Screening abgeschlossen wurde), `outcome` (`NO_CHANGE`, `CHANGED` oder `FAILED`), `provider` (opaker Bezeichner der AML-Datenquelle; nicht danach verzweigen), `aml_status`, `aml_score`, `total_hits`, `datasets_captured_at`, `datasets_sanctions_last_updated_at`, `datasets_pep_last_updated_at`, `datasets_warnings_last_updated_at`, `datasets_adverse_media_last_updated_at`, `datasets_catalog_version`, `run_id` (der Überwachungslauf), `entities_screened` (`1` oder `0` bei einem fehlgeschlagenen Lauf) und `new_hits` (leer, falls unbekannt). Datumsangaben entsprechen ISO 8601 mit UTC-Offset. Eine Sitzung ohne bisherige erneute Screenings gibt nur die Kopfzeile zurück. headers: Content-Disposition: description: >- `attachment; filename="aml-screening-history-{sessionId}.csv"` oder `aml-screening-history-{sessionId}-{month}.csv`, wenn `month` übergeben wird. schema: type: string example: >- attachment; filename="aml-screening-history-11111111-2222-3333-4444-555555555555.csv" content: text/csv: schema: type: string format: binary example: "screened_at,outcome,provider,aml_status,aml_score,total_hits,datasets_captured_at,datasets_sanctions_last_updated_at,datasets_pep_last_updated_at,datasets_warnings_last_updated_at,datasets_adverse_media_last_updated_at,datasets_catalog_version,run_id,entities_screened,new_hits\r\n2026-09-14T04:12:33.481207+00:00,NO_CHANGE,aml_data_source,Approved,0.0,0,2026-09-14T03:58:02.114820+00:00,2026-09-13T21:10:00+00:00,2026-09-13T08:00:00+00:00,2026-09-12T18:45:00+00:00,,2026-09-13,aaaaaaaa-1111-2222-3333-444444444444,1,0\r\n2026-09-13T04:11:58.020914+00:00,FAILED,aml_data_source,Approved,0.0,0,,,,,,,bbbbbbbb-1111-2222-3333-444444444444,0,\r\n" '400': description: '`month` ist kein `YYYY-MM`-Kalendermonat.' content: application/json: schema: type: object properties: month: type: array items: type: string examples: Malformed month: summary: month=2026-13 value: month: - Not a calendar month. Use YYYY-MM. '401': description: >- Der API-Schlüssel mit eingeschränktem Geltungsbereich ist abgelaufen. Dies ist der einzige Fall, der `401` zurückgibt: Ein fehlender, ungültiger oder widerrufener Schlüssel gibt `403` zurück. content: application/json: schema: type: object properties: detail: type: string description: Lesbare Fehlermeldung. examples: Expired key: summary: Das Ablaufdatum des Schlüssels ist überschritten value: detail: This API key has expired. '403': description: >- Authentifizierungs- oder Autorisierungsfehler. Ein fehlender Schlüssel gibt `403` zurück, ebenso wie der Schlüssel einer anderen Anwendung, ein berechtigungsbeschränkter Schlüssel ohne die für diesen Endpoint erforderliche Berechtigung sowie eine Anfrage von außerhalb der IP-Allowlist des Schlüssels; ein falscher, widerrufener oder abgelaufener Schlüssel gibt `401` zurück. Unterscheiden Sie diese anhand von `detail`. content: application/json: schema: type: object properties: detail: type: string description: Lesbare Fehlermeldung. examples: Missing or invalid credentials: summary: >- Kein x-api-key-Header vorhanden oder die Validierung des Schlüssels ist fehlgeschlagen value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: >- Ein gültiger Schlüssel, der zu einer anderen Anwendung als die Sitzung gehört value: detail: You do not have permission to perform this action. Scoped key without decisions read: summary: >- Dem Schlüssel mit eingeschränktem Berechtigungsumfang fehlt decisions: read value: detail: This API key has no read access to decisions. Scoped key without media read: summary: >- Dem Schlüssel mit eingeschränktem Berechtigungsumfang fehlt media: read (die Antwort ist eine Datei) value: detail: This API key has no read access to media. IP not allowed: summary: Anfrage von außerhalb der IP-Allowlist des Schlüssels value: detail: This API key can't be used from this IP address. '404': description: >- Die Sitzung existiert nicht, wurde gelöscht oder liegt außerhalb der Beschränkungen eines Scoped Keys, oder sie verfügt über keine AML-Prüfung (für die angegebene `node_id`). Die Sitzungssuche erfolgt vor der Prüfung der Anmeldedaten, sodass eine unbekannte `sessionId` auch ohne gültigen Schlüssel `404` zurückgibt. content: application/json: schema: type: object properties: detail: type: string description: Lesbare Fehlermeldung. examples: Unknown session: summary: >- Es existiert keine Sitzung mit dieser ID oder sie wurde gelöscht value: detail: Not found. Outside key limits: summary: >- Die Sitzung liegt außerhalb der Beschränkungen eines Scoped Keys (wird auch für eine vor Kurzem gelöschte Sitzung zurückgegeben) value: detail: Session not found. No AML check: summary: Die Sitzung hat nie einen AML-Schritt ausgeführt value: detail: The session does not have an AML check. No AML check for node: summary: node_id stimmt mit keiner AML-Prüfung der Sitzung überein value: detail: >- The session does not have an AML check for node 'feature_aml_2'. '429': description: >- Rate-Limit überschritten: 600 GET-Anfragen pro Minute pro API-Schlüssel. Warten Sie `Retry-After` Sekunden vor einem Wiederholungsversuch; die `X-RateLimit-*`-Header zeigen das Kontingent an. content: application/json: schema: type: object properties: detail: type: string description: Lesbare Fehlermeldung. examples: Rate limited: summary: Budget für die aktuelle Minute erschöpft value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: >- Sekunden, die vor einem Wiederholungsversuch gewartet werden müssen. schema: type: integer minimum: 1 example: 30 security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/export/' \ -H 'x-api-key: YOUR_API_KEY' \ -o aml-screening-history.csv - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() content = client.sessions.export_aml_screening_history( "11111111-2222-3333-4444-555555555555", ) with open("download.csv", "wb") as file: file.write(content) - lang: javascript label: Node.js source: >- import { writeFile } from "node:fs/promises"; import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const content = await didit.sessions.exportAmlScreeningHistory("11111111-2222-3333-4444-555555555555"); await writeFile("download.csv", Buffer.from(await content.arrayBuffer())); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresp, err := client.Sessions.ExportAMLScreeningHistory(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SessionsExportAMLScreeningHistoryParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer resp.Body.Close()\nfile, err := os.Create(\"download.csv\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer file.Close()\nif _, err := io.Copy(file, resp.Body); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import java.nio.file.Path; import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.sessions().exportAmlScreeningHistory("11111111-2222-3333-4444-555555555555") .writeTo(Path.of("download.csv")); - lang: php label: PHP source: >- sessions->exportAmlScreeningHistory('11111111-2222-3333-4444-555555555555'); $content->saveTo('download.csv'); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new content = didit.sessions.export_aml_screening_history("11111111-2222-3333-4444-555555555555") File.binwrite("download.csv", content) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var content = await client.Sessions.ExportAmlScreeningHistoryAsync("11111111-2222-3333-4444-555555555555"); await content.SaveToAsync("download.csv"); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder 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 stammte; 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 Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token 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.