> ## 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. # Exportar l'historial de cribratge AML en CSV: API > Descarrega l'historial de monitoratge AML continu d'una sessió en CSV, una línia per cada recribratge completat, a punt per a l'auditor amb Didit. Prompt de l'API per exportar l'historial de cribratge AML Copia el prompt al porta-retalls 
  \`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.\`
Enganxa a El fitxer conté els mateixos cribratges que [Llistar l'historial de cribratge AML](https://docs.didit.me/ca/management-api/sessions/aml-screening-history.md), aplanats en una línia per cada cribratge, amb la data d'actualització del conjunt de dades de cada família de llistes (sancions, PEP, advertències, mitjans adversos) per a la qual s'hagi informat d'una data. La Business Console ofereix la mateixa exportació al costat del resultat AML. Consulta [Monitoratge AML continu](https://docs.didit.me/ca/core-technology/aml-screening/continuous-monitoring-aml-screening.md) per saber què significa cada valor. ## OpenAPI ````yaml ca/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 verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/aml-screening-history/export/: get: tags: - Sessions summary: Exportar l'historial de cribratge AML com a CSV description: >- Descarrega el mateix historial de monitoratge continu que `GET /v3/session/{sessionId}/aml-screening-history/` en format de fitxer CSV, una línia per cada reanàlisi completada, començant per la més recent, a punt per entregar a un auditor. El fitxer es transmet sencer (sense paginació) i comença amb una línia de capçalera; una cel·la buida significa desconegut, les dates del conjunt de dades mai s'estimen i qualsevol valor que iniciï una fórmula de full de càlcul porta un apòstrof al davant. Funciona per a ID de sessió de KYC i KYB; passa `node_id` quan la sessió hagi executat més d'un pas d'AML. Passa `month` per exportar un mes natural. Els errors es retornen com a JSON, no com a CSV. Una clau d'API amb àmbit requereix `decisions: read` i `media: read`: la resposta és un fitxer, de manera que una clau sense `media: read` rep un `403`. operationId: get_v3_session_aml_screening_history_export parameters: - name: sessionId in: path required: true description: >- UUID de la sessió de verificació (el `session_id` retornat per `POST /v3/session/`). Accepta tant IDs de sessió de Verificació d'usuaris (KYC) com de Verificació d'empreses (KYB): el servidor resol l'ID entre tots dos tipus de sessió. Ha de ser un UUID ben format; un valor mal format no coincideix amb la ruta i retorna un `404` en HTML. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- ID del node del graf del flux de treball del cribratge AML. Només cal quan la sessió ha executat més d'un pas AML; si no s'especifica, s'utilitza el cribratge AML més recent. Un node desconegut fa que la crida retorni `404`. schema: type: string example: feature_aml_1 - name: month in: query required: false description: >- Un mes natural UTC en format `YYYY-MM`. Només es retornen els cribratges completats en aquest mes; sense ell, es retornen tots els mesos. Un mes amb un format incorrecte retorna `400`. schema: type: string pattern: ^\d{4}-(0[1-9]|1[0-2])$ example: 2026-09 responses: '200': description: >- El fitxer CSV, transmès com a `text/csv` amb salts de línia CRLF. Columnes, en ordre: `screened_at` (quan ha finalitzat el nou cribratge), `outcome` (`NO_CHANGE`, `CHANGED` o `FAILED`), `provider` (identificador opac de la font de dades AML; no en creïs bifurcacions lògiques), `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'execució del monitoratge), `entities_screened` (`1`, o `0` per a una execució fallida) i `new_hits` (buit quan es desconeix). Les dates són en format ISO 8601 amb un desplaçament UTC. Una sessió sense nous cribratges encara retorna només la línia de capçalera. headers: Content-Disposition: description: >- `attachment; filename="aml-screening-history-{sessionId}.csv"`, o `aml-screening-history-{sessionId}-{month}.csv` quan es passa `month`. 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` no és un mes natural `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 clau d'API amb abast ha caducat. Aquest és l'únic cas que retorna `401`: una clau absent, no vàlida o revocada retorna `403`. content: application/json: schema: type: object properties: detail: type: string description: Missatge d'error fàcil de llegir. examples: Expired key: summary: La data de caducitat de la clau ha passat value: detail: This API key has expired. '403': description: >- Fallada d'autenticació o d'autorització. Si falta la clau es retorna `403`, igual que amb una clau d'una altra aplicació, una clau amb àmbit sense el permís que necessita aquest endpoint o una sol·licitud des de fora de la llista d'adreces IP permeses de la clau; una clau incorrecta, revocada o caducada retorna `401`. Distingeix-les pel camp `detail`. content: application/json: schema: type: object properties: detail: type: string description: Missatge d'error fàcil de llegir. examples: Missing or invalid credentials: summary: >- Falta la capçalera x-api-key, o la clau ha fallat la validació value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: >- Una clau vàlida que pertany a una aplicació diferent de la de la sessió value: detail: You do not have permission to perform this action. Scoped key without decisions read: summary: >- A la clau amb abast li manca el permís de lectura de decisions value: detail: This API key has no read access to decisions. Scoped key without media read: summary: >- A la clau amb abast li manca el permís media: read (la resposta és un fitxer) value: detail: This API key has no read access to media. IP not allowed: summary: >- Sol·licitud des de fora de la llista d'adreces IP permeses de la clau value: detail: This API key can't be used from this IP address. '404': description: >- La sessió no existeix, s'ha suprimit o queda fora dels límits d'una clau amb abast limitat, o no té cap comprovació AML (per al `node_id` indicat). La cerca de la sessió s'executa abans de comprovar les credencials, de manera que un `sessionId` desconegut retorna `404` fins i tot sense una clau vàlida. content: application/json: schema: type: object properties: detail: type: string description: Missatge d'error fàcil de llegir. examples: Unknown session: summary: No existeix cap sessió amb aquest ID, o s'ha suprimit value: detail: Not found. Outside key limits: summary: >- La sessió queda fora dels límits d'una clau amb abast limitat (també es retorna per a una sessió suprimida fa uns moments) value: detail: Session not found. No AML check: summary: La sessió no ha executat mai cap pas d'AML value: detail: The session does not have an AML check. No AML check for node: summary: node_id no coincideix amb cap comprovació AML de la sessió value: detail: >- The session does not have an AML check for node 'feature_aml_2'. '429': description: >- S'ha superat el límit de freqüència: 600 sol·licituds GET per minut per clau d'API. Espera els segons indicats a `Retry-After` abans de reintentar; les capçaleres `X-RateLimit-*` mostren el pressupost. content: application/json: schema: type: object properties: detail: type: string description: Missatge d'error fàcil de llegir. examples: Rate limited: summary: Pressupost per al minut actual esgotat value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: Segons que cal esperar abans de reintentar. 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 clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.