List AML Screening History - Didit Documentation

curl

curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/' \
  -H 'x-api-key: YOUR_API_KEY'

import os

import requests

session_id = '11111111-2222-3333-4444-555555555555'
resp = requests.get(
    f'https://verification.didit.me/v3/session/{session_id}/aml-screening-history/',
    headers={'x-api-key': os.environ['DIDIT_API_KEY']},
    timeout=10,
)
resp.raise_for_status()
for run in resp.json()['results']:
    print(run['completed_at'], run['outcome'], run['status'])

const sessionId = '11111111-2222-3333-4444-555555555555';
const resp = await fetch(`https://verification.didit.me/v3/session/${sessionId}/aml-screening-history/`, {
  headers: { 'x-api-key': process.env.DIDIT_API_KEY },
});
if (!resp.ok) throw new Error(`Request failed: ${resp.status}`);
const page = await resp.json();
for (const run of page.results) console.log(run.completed_at, run.outcome, run.status);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://verification.didit.me/v3/session/{sessionId}/aml-screening-history/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://verification.didit.me/v3/session/{sessionId}/aml-screening-history/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://verification.didit.me/v3/session/{sessionId}/aml-screening-history/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "dddddddd-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,
      "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",
      "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,
      "dataset_freshness": null
    }
  ]
}

GET

session

{sessionId}

aml-screening-history

curl

curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/' \
  -H 'x-api-key: YOUR_API_KEY'

import os

import requests

session_id = '11111111-2222-3333-4444-555555555555'
resp = requests.get(
    f'https://verification.didit.me/v3/session/{session_id}/aml-screening-history/',
    headers={'x-api-key': os.environ['DIDIT_API_KEY']},
    timeout=10,
)
resp.raise_for_status()
for run in resp.json()['results']:
    print(run['completed_at'], run['outcome'], run['status'])

const sessionId = '11111111-2222-3333-4444-555555555555';
const resp = await fetch(`https://verification.didit.me/v3/session/${sessionId}/aml-screening-history/`, {
  headers: { 'x-api-key': process.env.DIDIT_API_KEY },
});
if (!resp.ok) throw new Error(`Request failed: ${resp.status}`);
const page = await resp.json();
for (const run of page.results) console.log(run.completed_at, run.outcome, run.status);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://verification.didit.me/v3/session/{sessionId}/aml-screening-history/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://verification.didit.me/v3/session/{sessionId}/aml-screening-history/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://verification.didit.me/v3/session/{sessionId}/aml-screening-history/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "dddddddd-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,
      "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",
      "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,
      "dataset_freshness": null
    }
  ]
}

Alerts, activity entries and webhooks fire only when a screening result moves, so this history is the record that a clean subject was still being screened. Continuous AML monitoring explains how re-screens run and what each field means. To hand the same history to an auditor as a file, use Export AML screening history.

Authorizations

x-api-key

string

header

required

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 missing, wrong, revoked or expired; 403 means 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

sessionId

string<uuid>

required

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.

Example:

"11111111-2222-3333-4444-555555555555"

Query Parameters

node_id

string

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.

Example:

"feature_aml_1"

limit

integer

default:50

Maximum number of screening runs per page. Defaults to 50. A value below 1 or a non-numeric value falls back to 50; a value above 1,000,000 returns 400.

Required range: 1 <= x <= 1000000

Example:

50

offset

integer

default:0

Number of results to skip before the first returned one. Defaults to 0; a negative or non-numeric value falls back to 0, a value above 1,000,000 returns 400. Prefer following the next and previous URLs.

Required range: 0 <= x <= 1000000

Example:

0

ordering

string

Optional sort override. The default order is -completed_at. Pass a result field name (for example completed_at, started_at, outcome or score) to sort ascending, prefix it with - to sort descending, and separate several fields with commas. Unknown fields are ignored.

Example:

"completed_at"

Response

One page of screening runs, newest first.

count

integer

required

Number of runs, exact up to 100 and capped at 100 above that.

Required range: x <= 100

string<uri> | null

required

URL of the next page, or null on the last page.

string<uri> | null

required

URL of the previous page, or null on the first page.

results

object[]

required

Show child attributes