Histórico de triagem AML: listar via API

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 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);
}

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.Sessions.ListAMLScreeningHistoryAutoPaging(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsListAMLScreeningHistoryParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

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);
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

foreach ($didit->sessions->listAmlScreeningHistory('11111111-2222-3333-4444-555555555555') as $item) {
    print_r($item->toArray());
}

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));
}

{
  "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
    }
  ]
}

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 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);
}

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.Sessions.ListAMLScreeningHistoryAutoPaging(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsListAMLScreeningHistoryParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

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);
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

foreach ($didit->sessions->listAmlScreeningHistory('11111111-2222-3333-4444-555555555555') as $item) {
    print_r($item->toArray());
}

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));
}

{
  "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
    }
  ]
}

Alertas, entradas de atividade e webhooks são disparados apenas quando um resultado de análise muda; por isso, este histórico é o registro de que um titular sem ocorrências continuou sendo analisado. Monitoramento AML contínuo explica como as novas análises são executadas e o que cada campo significa. Para entregar esse mesmo histórico a um auditor como um arquivo, use Exportar histórico de análise AML.

Autorizações

x-api-key

string

header

obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

sessionId

string<uuid>

obrigatório

UUID da sessão de verificação (o session_id retornado por POST /v3/session/). Aceita IDs de sessão tanto de Verificação de usuários (KYC) quanto de Verificação de empresas (KYB): o servidor resolve o ID entre os dois tipos de sessão. Deve ser um UUID bem formado; um valor malformado não corresponde à rota e retorna um 404 em HTML.

Exemplo:

"11111111-2222-3333-4444-555555555555"

Parâmetros de consulta

node_id

string

ID do nó do grafo do fluxo da verificação AML. Necessário apenas quando a sessão executou mais de uma etapa AML; sem ele, é usada a verificação AML mais recente. Um nó desconhecido retorna 404.

Exemplo:

"feature_aml_1"

month

string

Um mês do calendário UTC no formato YYYY-MM. Somente as triagens concluídas nesse mês são retornadas; sem ele, todos os meses são retornados. Um mês malformado retorna 400.

Pattern: ^\d{4}-(0[1-9]|1[0-2])$

Exemplo:

"2026-09"

limit

integer

padrão:50

Número máximo de execuções de triagem por página. O padrão é 50. Um valor abaixo de 1 ou não numérico volta para 50; um valor acima de 1,000,000 retorna 400.

Intervalo obrigatório: 1 <= x <= 1000000

Exemplo:

50

offset

integer

padrão:0

Número de resultados a pular antes do primeiro retornado. O padrão é 0; um valor negativo ou não numérico volta para 0, e um valor acima de 1,000,000 retorna 400. Prefira seguir as URLs next e previous.

Intervalo obrigatório: 0 <= x <= 1000000

Exemplo:

0

ordering

string

Substituição opcional da ordenação. A ordem padrão é -completed_at. Informe o nome de um campo do resultado (por exemplo completed_at, started_at, outcome ou score) para ordenar em ordem crescente, adicione o prefixo - para ordenar em ordem decrescente e separe vários campos com vírgulas. Campos desconhecidos são ignorados.

Exemplo:

"completed_at"

Resposta

Uma página de execuções de análise, das mais recentes para as mais antigas.

count

integer

obrigatório

Número de execuções, exato até 100 e limitado a 100 acima disso.

Intervalo obrigatório: x <= 100

string<uri> | null

obrigatório

URL da próxima página, ou null na última página.

string<uri> | null

obrigatório

URL da página anterior, ou null na primeira página.

results

object[]

obrigatório

Show child attributes

Última modificação em 1 de novembro de 2026