> ## 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-Screening-Verlauf per API abrufen > Didit API: Alle Läufe der laufenden AML-Überwachung einer Sitzung abrufen, auch ohne Änderungen, mit Ergebnis, Score und Datenaktualität. API-Prompt zum Abrufen des AML-Screening-Verlaufs Prompt in die Zwischenablage kopieren 
  \`List the ongoing AML monitoring history of one Didit verification session through the API.

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

  Authentication:
  Send my Didit API key in the x-api-key header. A scoped key needs decisions: read.

  Goal:

  * Prove that ongoing AML monitoring ran for a subject, including the re-screens that found nothing new, for example to answer 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.
  * limit (default 50) and offset: pagination.

  Behavior:

  * Works for user (KYC) and business (KYB) session IDs.
  * Returns { count, next, previous, results }, newest first by completed\_at. count is exact up to 100 and capped at 100 above that, so follow next until it is null.
  * Only ongoing-monitoring re-screens are listed. The first screening is part of the session decision, so a session without ongoing monitoring returns an empty list.
  * History starts when the feature was introduced; earlier screenings are not reconstructed.

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

  What to read from the response:

  * results\[].completed\_at: when the re-screen finished. started\_at: when its batch started.
  * results\[].outcome: NO\_CHANGE (completed, result unchanged), CHANGED (score, status or hits moved) or FAILED (no usable answer for this subject, nothing changed).
  * results\[].status, score and total\_hits: the state the re-screen left the check in.
  * results\[].dataset\_freshness: how current the screening datasets were (sources.sanctions, pep, warnings, adverse\_media with last\_updated\_at and oldest\_updated\_at), or null when no dates were available. Dates are never estimated.
  * results\[].provider and dataset\_freshness.provider: an identifier of the data source. Treat it as an opaque string.

  Failure modes:

  * 400: limit or offset above 1,000,000.
  * 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 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 Alerts, Aktivitätseinträge und Webhooks werden nur ausgelöst, wenn sich ein Screening-Ergebnis ändert. Dieser Verlauf ist daher der Nachweis, dass ein unauffälliges Prüfobjekt weiterhin überprüft wurde. [Laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening.md) erklärt, wie erneute Screenings ablaufen und was jedes Feld bedeutet. Um denselben Verlauf einem Auditor als Datei zu übergeben, verwenden Sie [AML-Screening-Verlauf exportieren](https://docs.didit.me/de/management-api/sessions/export-aml-screening-history.md). ## OpenAPI ````yaml de/openapi-25.json GET /v3/session/{sessionId}/aml-screening-history/ 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/: get: tags: - Sessions summary: AML-Screening-Historie auflisten description: >- Jedes abgeschlossene Re-Screening der laufenden Überwachung für die AML-Prüfung einer Sitzung auflisten, neueste zuerst nach `completed_at`, einschließlich der Durchläufe ohne Änderungen: Alerts, Aktivitätseinträge und Webhooks werden nur ausgelöst, wenn sich ein Ergebnis ändert; dieser Verlauf dient daher als Nachweis, dass eine unauffällige Entität weiterhin einem Screening unterzogen wurde. Funktioniert für KYC- und KYB-Sitzungs-IDs; übergeben Sie `node_id`, wenn die Sitzung mehr als einen AML-Schritt ausgeführt hat. Es werden nur Re-Screenings der laufenden Überwachung aufgeführt (das erste Screening ist Teil der Sitzungsentscheidung) und Durchläufe vor der Einführung dieses Verlaufs werden nicht rekonstruiert; eine Sitzung ohne laufende Überwachung gibt daher eine leere Liste zurück. `count` ist bis 100 exakt und darüber auf 100 begrenzt, folgen Sie also `next`, bis der Wert `null` ist. Übergeben Sie `month`, um jeweils einen Kalendermonat auszulesen. Ein berechtigungsbeschränkter API-Schlüssel erfordert `decisions: read`; siehe [Laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening). operationId: get_v3_session_aml_screening_history 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 - name: limit in: query required: false description: >- Maximale Anzahl an Screening-Durchläufen pro Seite. Standardmäßig 50. Ein Wert unter 1 oder ein nicht-numerischer Wert fällt auf 50 zurück; ein Wert über 1.000.000 gibt `400` zurück. schema: type: integer default: 50 minimum: 1 maximum: 1000000 example: 50 - name: offset in: query required: false description: >- Anzahl der vor dem ersten zurückgegebenen Ergebnis zu überspringenden Ergebnisse. Standardmäßig 0; ein negativer oder nicht-numerischer Wert fällt auf 0 zurück, ein Wert über 1.000.000 gibt `400` zurück. Folgen Sie vorzugsweise den `next`- und `previous`-URLs. schema: type: integer default: 0 minimum: 0 maximum: 1000000 example: 0 - name: ordering in: query required: false description: >- Optionale Überschreibung der Sortierung. Die Standardreihenfolge ist `-completed_at`. Übergeben Sie den Namen eines Ergebnisfelds (z. B. `completed_at`, `started_at`, `outcome` oder `score`), um aufsteigend zu sortieren, stellen Sie ein `-` voran, um absteigend zu sortieren, und trennen Sie mehrere Felder durch Kommas. Unbekannte Felder werden ignoriert. schema: type: string example: completed_at responses: '200': description: Eine Seite mit Screening-Durchläufen, neueste zuerst. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer maximum: 100 description: >- Anzahl der Durchläufe, exakt bis 100 und darüber auf 100 begrenzt. next: type: string format: uri nullable: true description: URL der nächsten Seite oder `null` auf der letzten Seite. previous: type: string format: uri nullable: true description: URL der vorherigen Seite oder `null` auf der ersten Seite. results: type: array items: $ref: '#/components/schemas/AMLScreeningRun' examples: Monitored subject: value: count: 2 next: null previous: null results: - uuid: dddddddd-1111-2222-3333-444444444444 run_id: aaaaaaaa-1111-2222-3333-444444444444 completed_at: '2026-09-14T04:12:33.481207Z' started_at: '2026-09-14T04:00:01.002311Z' outcome: NO_CHANGE trigger: ONGOING_MONITORING provider: aml_data_source status: Approved score: 0 total_hits: 0 new_hits: 0 entities_screened: 1 dataset_freshness: captured_at: '2026-09-14T03:58:02.114820+00:00' provider: aml_data_source catalog_version: '2026-09-13' sources: sanctions: last_updated_at: '2026-09-13T21:10:00+00:00' oldest_updated_at: '2026-09-11T06:00:00+00:00' dataset_count: 120 dated_dataset_count: 120 pep: last_updated_at: '2026-09-13T08:00:00+00:00' oldest_updated_at: null dataset_count: 45 dated_dataset_count: 44 warnings: last_updated_at: '2026-09-12T18:45:00+00:00' oldest_updated_at: '2026-09-01T00:00:00+00:00' dataset_count: 30 dated_dataset_count: 30 - uuid: eeeeeeee-1111-2222-3333-444444444444 run_id: bbbbbbbb-1111-2222-3333-444444444444 completed_at: '2026-09-13T04:11:58.020914Z' started_at: '2026-09-13T04:00:00.871022Z' outcome: FAILED trigger: ONGOING_MONITORING provider: aml_data_source status: Approved score: 0 total_hits: 0 new_hits: null entities_screened: 0 dataset_freshness: null '400': description: >- `limit` oder `offset` liegt über 1,000,000 (ein JSON-Array mit einer Nachricht), oder `month` ist kein `YYYY-MM`-Kalendermonat (ein Objekt mit dem Schlüssel `month`). content: application/json: examples: Limit too large: summary: limit=2000000 value: - limit must not exceed 1000000. Offset too large: summary: offset=2000000 value: - offset must not exceed 1000000. Malformed month: summary: month=2026-13 value: month: - Not a calendar month. Use YYYY-MM. schema: oneOf: - type: array items: type: string - type: object properties: month: type: array items: type: string '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. 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/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.sessions.list_aml_screening_history( "11111111-2222-3333-4444-555555555555", ): print(item) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.sessions.listAmlScreeningHistory("11111111-2222-3333-4444-555555555555")) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Sessions.ListAMLScreeningHistoryAutoPaging(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SessionsListAMLScreeningHistoryParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.sessions().listAmlScreeningHistory("11111111-2222-3333-4444-555555555555")) { System.out.println(item); } - lang: php label: PHP source: >- sessions->listAmlScreeningHistory('11111111-2222-3333-4444-555555555555') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.sessions.list_aml_screening_history("11111111-2222-3333-4444-555555555555").auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.Sessions.ListAmlScreeningHistoryAsync("11111111-2222-3333-4444-555555555555")) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: AMLScreeningRun: type: object description: >- Ein abgeschlossenes Re-Screening einer AML-Prüfung im Rahmen der laufenden Überwachung. required: - uuid - run_id - completed_at - started_at - outcome - trigger - provider - status - score - total_hits - new_hits - entities_screened - dataset_freshness properties: uuid: type: string format: uuid description: Kennung dieses Screening-Laufs. run_id: type: string format: uuid description: >- Der Überwachungslauf, zu dem dieses Screening gehört. Jede im selben Lauf überprüfte Verifizierung hat denselben Lauf. completed_at: type: string format: date-time description: >- Wann das erneute Screening dieses Subjekts abgeschlossen wurde. Die Ergebnisse sind danach sortiert, neueste zuerst. started_at: type: string format: date-time description: >- Wann der Überwachungs-Batch begann, zu dem diese erneute Überprüfung gehört. outcome: type: string enum: - NO_CHANGE - CHANGED - FAILED description: >- `NO_CHANGE`: Abgeschlossen und das Ergebnis hat sich nicht geändert. `CHANGED`: Abgeschlossen und der Score, Status, die Trefferanzahl oder die Treffer haben sich geändert. `FAILED`: Keine verwertbare Antwort für dieses Subjekt, daher blieb die Prüfung unverändert. trigger: type: string enum: - ONGOING_MONITORING description: Was das Screening gestartet hat. Derzeit immer `ONGOING_MONITORING`. provider: type: string description: >- Opake Kennung der AML-Datenquelle, die geantwortet hat. Als opaken String behandeln; nicht danach verzweigen. example: aml_data_source status: type: string nullable: true enum: - Not Finished - Approved - Declined - In Review - Resub Requested - null description: Status der AML-Prüfung, den diese nach diesem Lauf hatte. score: type: number format: float nullable: true minimum: 0 maximum: 100 description: AML-Score, den die Prüfung nach diesem Lauf hatte. total_hits: type: integer nullable: true description: >- Anzahl der Treffer, mit denen dieser Durchlauf die Prüfung hinterlassen hat. new_hits: type: integer nullable: true description: >- Anzahl der Treffer, die dieser Durchlauf gefunden hat und die die Prüfung zuvor nicht aufwies. `0`, wenn nichts Neues gefunden wurde; `null`, wenn der Durchlauf fehlschlug oder aufgezeichnet wurde, bevor diese Zählung existierte. entities_screened: type: integer minimum: 0 maximum: 1 description: >- Anzahl der Entitäten, die dieser Durchlauf für die Verifizierung überprüft hat: `1`, wenn das Subjekt überprüft wurde, `0`, wenn der Durchlauf fehlgeschlagen ist. dataset_freshness: allOf: - $ref: '#/components/schemas/AMLDatasetFreshness' nullable: true description: >- Aktualität des Datensatzes hinter diesem Durchlauf oder `null`, wenn keine Datumsangaben verfügbar waren. AMLDatasetFreshness: type: object description: >- Wie aktuell die AML-Datensätze bei der Durchführung eines Screenings waren. Datumsangaben werden niemals geschätzt. required: - captured_at - provider - catalog_version - sources properties: captured_at: type: string format: date-time description: >- Wann Didit den Datensatzkatalog gelesen hat, aus dem diese Aktualität stammt. provider: type: string description: >- Opake Kennung der AML-Datenquelle. Als opaken String behandeln; nicht danach verzweigen. example: aml_data_source catalog_version: type: string nullable: true description: >- Versionskennung des Datensatzkatalogs, sofern die Quelle eine meldet. sources: type: object description: >- Aktualität pro Datensatzfamilie. Eine Familie, deren Datensätze kein Aktualisierungsdatum gemeldet haben, fehlt, anstatt mit `null` gefüllt zu werden. properties: sanctions: $ref: '#/components/schemas/AMLDatasetSourceFreshness' pep: $ref: '#/components/schemas/AMLDatasetSourceFreshness' warnings: $ref: '#/components/schemas/AMLDatasetSourceFreshness' adverse_media: $ref: '#/components/schemas/AMLDatasetSourceFreshness' AMLDatasetSourceFreshness: type: object description: Aktualität einer Familie von AML-Datensätzen. required: - last_updated_at - oldest_updated_at - dataset_count - dated_dataset_count properties: last_updated_at: type: string format: date-time description: Neueste Aktualisierung eines beliebigen Datensatzes in der Familie. oldest_updated_at: type: string format: date-time nullable: true description: >- Aktualitätsgrenze: Jeder Datensatz in der Familie ist mindestens so aktuell. `null`, wenn mindestens ein Datensatz in der Familie kein Aktualisierungsdatum gemeldet hat, da die Grenze dann unbekannt ist. dataset_count: type: integer description: Anzahl der Datensätze in der Familie. dated_dataset_count: type: integer description: Anzahl der Datensätze, die ein Aktualisierungsdatum gemeldet haben. 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.