> ## 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. # Exporter l'historique de filtrage AML en CSV | API Didit > Téléchargez l'historique de surveillance AML continue d'une session au format CSV, une ligne par re-filtrage terminé, prête à remettre à un auditeur. Prompt de l'API d'export de l'historique de filtrage AML Copier le prompt dans le presse-papiers 
  \`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.\`
Coller dans Le fichier contient les mêmes filtrages que [Lister l'historique de filtrage AML](https://docs.didit.me/fr/management-api/sessions/aml-screening-history.md), présentés chacun sur une seule ligne, avec la date de mise à jour du jeu de données de chaque famille de listes (sanctions, PEP, avertissements, presse négative) lorsqu'une date de mise à jour a été communiquée. La Business Console propose le même export à côté du résultat AML. Consultez [Surveillance AML continue](https://docs.didit.me/fr/core-technology/aml-screening/continuous-monitoring-aml-screening.md) pour la signification de chaque valeur. ## OpenAPI ````yaml fr/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 de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/aml-screening-history/export/: get: tags: - Sessions summary: Exporter l'historique de filtrage AML au format CSV description: "Télécharger le même historique de surveillance continue que `GET /v3/session/{sessionId}/aml-screening-history/` sous la forme d'un fichier CSV, à raison d'une ligne par nouveau filtrage terminé, de la plus récente à la plus ancienne, prêt à être transmis à un auditeur. Le fichier est transmis en continu dans son intégralité (sans pagination) et commence par une ligne d'en-tête\_; une cellule vide signifie inconnue, les dates des jeux de données ne sont jamais estimées et une valeur débutant par une formule de tableur est précédée d'une apostrophe. Fonctionne pour les identifiants de session KYC et KYB\_; transmettez `node_id` lorsque la session a exécuté plus d'une étape AML. Transmettez `month` pour exporter un mois civil. Les erreurs sont renvoyées au format JSON, et non CSV. Une clé API avec permissions restreintes nécessite `decisions: read` et `media: read`\_: la réponse étant un fichier, une clé sans `media: read` reçoit une erreur `403`." operationId: get_v3_session_aml_screening_history_export parameters: - name: sessionId in: path required: true description: >- UUID de la session de vérification (le `session_id` renvoyé par `POST /v3/session/`). Accepte les identifiants de session de Vérification des utilisateurs (KYC) et de Vérification d'entreprise (KYB) : le serveur résout l'identifiant pour les deux types de session. Doit être un UUID bien formé ; une valeur malformée ne correspond pas à la route et renvoie une erreur HTML `404`. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- ID de nœud du graphe de workflow du contrôle AML. Nécessaire uniquement lorsque la session a exécuté plusieurs étapes AML ; sans cela, le contrôle AML le plus récent est utilisé. Un nœud inconnu renvoie `404`. schema: type: string example: feature_aml_1 - name: month in: query required: false description: >- Un mois civil UTC au format `YYYY-MM`. Seuls les filtrages effectués au cours de ce mois sont renvoyés ; sans ce paramètre, tous les mois sont renvoyés. Un mois mal formé renvoie `400`. schema: type: string pattern: ^\d{4}-(0[1-9]|1[0-2])$ example: 2026-09 responses: '200': description: >- Le fichier CSV, transmis sous forme de flux `text/csv` avec des sauts de ligne CRLF. Colonnes, dans l'ordre : `screened_at` (moment où le refiltrage s'est terminé), `outcome` (`NO_CHANGE`, `CHANGED` ou `FAILED`), `provider` (identifiant opaque de la source de données AML ; n'appliquez pas de logique conditionnelle dessus), `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` (l'exécution de surveillance), `entities_screened` (`1`, ou `0` pour une exécution échouée) et `new_hits` (vide si inconnu). Les dates sont au format ISO 8601 avec un décalage UTC. Une session sans refiltrage pour le moment renvoie uniquement la ligne d'en-tête. headers: Content-Disposition: description: >- `attachment; filename="aml-screening-history-{sessionId}.csv"`, ou `aml-screening-history-{sessionId}-{month}.csv` lorsque `month` est transmis. 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` n''est pas un mois calendaire `YYYY-MM`.' 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: >- La clé API restreinte a expiré. C'est le seul cas qui renvoie `401` : une clé manquante, invalide ou révoquée renvoie `403`. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Expired key: summary: La date d'expiration de la clé est dépassée value: detail: This API key has expired. '403': description: >- Échec d'authentification ou d'autorisation. Une clé manquante renvoie `403`, tout comme la clé d'une autre application, une clé restreinte ne disposant pas de l'autorisation requise par cet endpoint, ou une requête provenant de l'extérieur de la liste d'adresses IP autorisées de la clé ; une clé incorrecte, révoquée ou expirée renvoie `401`. Distinguez-les grâce au champ `detail`. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Missing or invalid credentials: summary: Aucun en-tête x-api-key, ou la validation de la clé a échoué value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: >- Une clé valide qui appartient à une application différente de la session value: detail: You do not have permission to perform this action. Scoped key without decisions read: summary: 'La clé restreinte ne dispose pas de decisions: read' value: detail: This API key has no read access to decisions. Scoped key without media read: summary: >- La clé restreinte ne dispose pas de media: read (la réponse est un fichier) value: detail: This API key has no read access to media. IP not allowed: summary: >- Requête provenant de l'extérieur de la liste d'adresses IP autorisées de la clé value: detail: This API key can't be used from this IP address. '404': description: >- La session n'existe pas, a été supprimée ou se trouve en dehors des limites d'une clé restreinte, ou elle ne comporte aucune vérification AML (pour le `node_id` indiqué). La recherche de session s'exécute avant la vérification des identifiants, donc un `sessionId` inconnu renvoie `404` même sans clé valide. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Unknown session: summary: Aucune session avec cet ID n'existe, ou elle a été supprimée value: detail: Not found. Outside key limits: summary: >- La session se trouve en dehors des limites d'une clé restreinte (également renvoyée pour une session supprimée il y a quelques instants) value: detail: Session not found. No AML check: summary: La session n'a jamais exécuté d'étape AML value: detail: The session does not have an AML check. No AML check for node: summary: >- node_id ne correspond à aucune vérification AML de la session value: detail: >- The session does not have an AML check for node 'feature_aml_2'. '429': description: >- Limite de débit dépassée : 600 requêtes GET par minute par clé API. Attendez `Retry-After` secondes avant de réessayer ; les en-têtes `X-RateLimit-*` indiquent le quota. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Rate limited: summary: Budget épuisé pour la minute en cours value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: Secondes à attendre avant de réessayer. 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: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.