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.csvfrom 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)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()));ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
resp, err := client.Sessions.ExportAMLScreeningHistory(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsExportAMLScreeningHistoryParams{})
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.csv")
if err != nil {
log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
log.Fatal(err)
}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"));<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$content = $didit->sessions->exportAmlScreeningHistory('11111111-2222-3333-4444-555555555555');
$content->saveTo('download.csv');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)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");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
2026-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
2026-09-13T04:11:58.020914+00:00,FAILED,aml_data_source,Approved,0.0,0,,,,,,,bbbbbbbb-1111-2222-3333-444444444444,0,Export AML Screening History as CSV API
Download the ongoing AML monitoring history of a session as a CSV file, one line per completed re-screen, ready to hand to an auditor.
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.csvfrom 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)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()));ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
resp, err := client.Sessions.ExportAMLScreeningHistory(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsExportAMLScreeningHistoryParams{})
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.csv")
if err != nil {
log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
log.Fatal(err)
}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"));<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$content = $didit->sessions->exportAmlScreeningHistory('11111111-2222-3333-4444-555555555555');
$content->saveTo('download.csv');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)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");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
2026-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
2026-09-13T04:11:58.020914+00:00,FAILED,aml_data_source,Approved,0.0,0,,,,,,,bbbbbbbb-1111-2222-3333-444444444444,0,Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Path Parameters
UUID of the verification session (the session_id returned by POST /v3/session/). Accepts both User Verification (KYC) and Business Verification (KYB) session IDs: the server resolves the ID across both session types. Must be a well-formed UUID; a malformed value does not match the route and returns an HTML 404.
"11111111-2222-3333-4444-555555555555"
Query Parameters
Workflow graph node ID of the AML check. Needed only when the session ran more than one AML step; without it the most recent AML check is used. An unknown node returns 404.
"feature_aml_1"
A UTC calendar month as YYYY-MM. Only screenings completed in that month are returned; without it every month is returned. A malformed month returns 400.
^\d{4}-(0[1-9]|1[0-2])$"2026-09"
Response
The CSV file, streamed as text/csv with CRLF line endings. Columns, in order: screened_at (when the re-screen finished), outcome (NO_CHANGE, CHANGED or FAILED), provider (opaque identifier of the AML data source; do not branch on it), 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 (the monitoring run), entities_screened (1, or 0 for a failed run) and new_hits (empty when unknown). Dates are ISO 8601 with a UTC offset. A session with no re-screens yet returns the header line only.
The response is of type file.