AMLスクリーニング履歴の一覧取得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
    }
  ]
}

アラート、アクティビティ記録、Webhookはスクリーニング結果が変化したときにのみ発生するため、この履歴は、問題のない対象者が引き続きスクリーニングされていたことを示す記録になります。再スクリーニングの実行方法と各フィールドの意味については、継続的なAMLモニタリングを参照してください。同じ履歴をファイルとして監査担当者に渡すには、AMLスクリーニング履歴のエクスポートを使用します。

承認

x-api-key

string

header

必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

sessionId

string<uuid>

必須

検証セッションのUUID(POST /v3/session/が返すsession_id)。ユーザー認証(KYC)と法人確認(KYB)の両方のセッションIDを受け付けます。サーバーは両方のセッションタイプにわたってIDを解決します。正しい形式のUUIDである必要があります。形式が不正な値はルートに一致せず、HTMLの404を返します。

例:

"11111111-2222-3333-4444-555555555555"

クエリパラメータ

node_id

string

AMLチェックのワークフローグラフのノードID。セッションで複数のAMLステップが実行された場合にのみ必要です。指定しない場合は最新のAMLチェックが使用されます。不明なノードを指定すると404が返されます。

例:

"feature_aml_1"

month

string

YYYY-MM形式のUTC暦月。その月に完了したスクリーニングのみが返されます。指定しない場合はすべての月が返されます。形式が不正な月を指定すると400が返されます。

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

例:

"2026-09"

limit

integer

デフォルト:50

1ページあたりの最大スクリーニング実行数です。デフォルトは50です。1未満の値または数値以外の値は50にフォールバックし、1,000,000を超える値は400を返します。

必須範囲: 1 <= x <= 1000000

例:

50

offset

integer

デフォルト:0

最初に返す結果の前にスキップする結果の件数です。デフォルトは0です。負の値または数値でない値は0として扱われ、1,000,000を超える値は400を返します。nextとpreviousのURLをたどる方法を推奨します。

必須範囲: 0 <= x <= 1000000

例:

0

ordering

string

任意の並べ替え指定です。デフォルトの順序は-completed_atです。結果のフィールド名（例：completed_at、started_at、outcome、score）を渡すと昇順に並べ替えられ、先頭に-を付けると降順になります。複数のフィールドはカンマで区切ります。不明なフィールドは無視されます。

例:

"completed_at"

レスポンス

スクリーニング実行の1ページ分です。新しい順に並びます。

count

integer

必須

実行回数です。100件までは正確な値で、それを超える場合は100で打ち切られます。

必須範囲: x <= 100

string<uri> | null

必須

次のページのURL。最後のページではnullです。

string<uri> | null

必須

前のページのURL。最初のページではnullです。

results

object[]

必須

Show child attributes

最終更新日 2026年11月1日