> ## 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. # AMLスクリーニング履歴の一覧取得API > Didit APIで、セッションに対する継続的なAMLモニタリングの再スクリーニングをすべて一覧取得します。変更のなかった実行も含め、結果、スコア、データセットの鮮度を確認できます。 AMLスクリーニング履歴一覧APIプロンプト プロンプトをクリップボードにコピー 
  \`List the ongoing AML monitoring history of one Didit verification session through the API.

  Endpoint:
  GET [https://verification.didit.me/v3/session/\{session\_id}/aml-screening-history/](https://verification.didit.me/v3/session/\{session_id}/aml-screening-history/)

  Authentication:
  Send my Didit API key in the x-api-key header. A scoped key needs decisions: read.

  Goal:

  * Prove that ongoing AML monitoring ran for a subject, including the re-screens that found nothing new, for example to answer 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.
  * limit (default 50) and offset: pagination.

  Behavior:

  * Works for user (KYC) and business (KYB) session IDs.
  * Returns { count, next, previous, results }, newest first by completed\_at. count is exact up to 100 and capped at 100 above that, so follow next until it is null.
  * Only ongoing-monitoring re-screens are listed. The first screening is part of the session decision, so a session without ongoing monitoring returns an empty list.
  * History starts when the feature was introduced; earlier screenings are not reconstructed.

  Example call:
  curl -X GET "[https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/](https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/aml-screening-history/)" \
  -H "x-api-key: YOUR\_API\_KEY"

  What to read from the response:

  * results\[].completed\_at: when the re-screen finished. started\_at: when its batch started.
  * results\[].outcome: NO\_CHANGE (completed, result unchanged), CHANGED (score, status or hits moved) or FAILED (no usable answer for this subject, nothing changed).
  * results\[].status, score and total\_hits: the state the re-screen left the check in.
  * results\[].dataset\_freshness: how current the screening datasets were (sources.sanctions, pep, warnings, adverse\_media with last\_updated\_at and oldest\_updated\_at), or null when no dates were available. Dates are never estimated.
  * results\[].provider and dataset\_freshness.provider: an identifier of the data source. Treat it as an opaque string.

  Failure modes:

  * 400: limit or offset above 1,000,000.
  * 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 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.\`
貼り付け先 アラート、アクティビティ記録、Webhookはスクリーニング結果が変化したときにのみ発生するため、この履歴は、問題のない対象者が引き続きスクリーニングされていたことを示す記録になります。再スクリーニングの実行方法と各フィールドの意味については、[継続的なAMLモニタリング](https://docs.didit.me/ja/core-technology/aml-screening/continuous-monitoring-aml-screening.md)を参照してください。同じ履歴をファイルとして監査担当者に渡すには、[AMLスクリーニング履歴のエクスポート](https://docs.didit.me/ja/management-api/sessions/export-aml-screening-history.md)を使用します。 ## OpenAPI ````yaml ja/openapi-25.json GET /v3/session/{sessionId}/aml-screening-history/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 本人確認API。x-api-keyヘッダーで認証します。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/aml-screening-history/: get: tags: - Sessions summary: AMLスクリーニング履歴の一覧取得 description: >- セッションのAMLチェックについて、完了した継続的なモニタリングの再スクリーニングをすべて、`completed_at`の新しい順に一覧表示します。何も変化しなかった実行も含まれます。アラート、アクティビティエントリ、Webhookは結果が変化した場合にのみ発生するため、この履歴は、問題のない対象者が引き続きスクリーニングされていたことの証拠となります。KYCとKYBのセッションIDに対応しています。セッションで複数のAMLステップを実行した場合は`node_id`を指定してください。一覧に含まれるのは継続的なモニタリングの再スクリーニングのみで(最初のスクリーニングはセッションの判定の一部です)、この履歴が存在する以前の実行は再構築されません。そのため、継続的なモニタリングのないセッションでは空の一覧が返されます。`count`は100までは正確で、それを超える場合は100が上限となるため、`next`が`null`になるまでたどってください。1暦月ずつ読み取るには`month`を指定します。スコープ付きAPIキーには`decisions: read`が必要です。[継続的なAMLモニタリング](https://docs.didit.me/ja/core-technology/aml-screening/continuous-monitoring-aml-screening)を参照してください。 operationId: get_v3_session_aml_screening_history parameters: - name: sessionId in: path required: true description: >- 検証セッションのUUID(`POST /v3/session/`が返す`session_id`)。ユーザー認証(KYC)と法人確認(KYB)の両方のセッションIDを受け付けます。サーバーは両方のセッションタイプにわたってIDを解決します。正しい形式のUUIDである必要があります。形式が不正な値はルートに一致せず、HTMLの`404`を返します。 schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- AMLチェックのワークフローグラフのノードID。セッションで複数のAMLステップが実行された場合にのみ必要です。指定しない場合は最新のAMLチェックが使用されます。不明なノードを指定すると`404`が返されます。 schema: type: string example: feature_aml_1 - name: month in: query required: false description: >- `YYYY-MM`形式のUTC暦月。その月に完了したスクリーニングのみが返されます。指定しない場合はすべての月が返されます。形式が不正な月を指定すると`400`が返されます。 schema: type: string pattern: ^\d{4}-(0[1-9]|1[0-2])$ example: 2026-09 - name: limit in: query required: false description: >- 1ページあたりの最大スクリーニング実行数です。デフォルトは50です。1未満の値または数値以外の値は50にフォールバックし、1,000,000を超える値は`400`を返します。 schema: type: integer default: 50 minimum: 1 maximum: 1000000 example: 50 - name: offset in: query required: false description: >- 最初に返す結果の前にスキップする結果の件数です。デフォルトは0です。負の値または数値でない値は0として扱われ、1,000,000を超える値は`400`を返します。`next`と`previous`のURLをたどる方法を推奨します。 schema: type: integer default: 0 minimum: 0 maximum: 1000000 example: 0 - name: ordering in: query required: false description: >- 任意の並べ替え指定です。デフォルトの順序は`-completed_at`です。結果のフィールド名（例：`completed_at`、`started_at`、`outcome`、`score`）を渡すと昇順に並べ替えられ、先頭に`-`を付けると降順になります。複数のフィールドはカンマで区切ります。不明なフィールドは無視されます。 schema: type: string example: completed_at responses: '200': description: スクリーニング実行の1ページ分です。新しい順に並びます。 content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer maximum: 100 description: 実行回数です。100件までは正確な値で、それを超える場合は100で打ち切られます。 next: type: string format: uri nullable: true description: 次のページのURL。最後のページでは`null`です。 previous: type: string format: uri nullable: true description: 前のページのURL。最初のページでは`null`です。 results: type: array items: $ref: '#/components/schemas/AMLScreeningRun' examples: Monitored subject: value: 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 '400': description: >- `limit`または`offset`が1,000,000を超えている（メッセージ1件を含むJSON配列）、または`month`が`YYYY-MM`形式の暦月ではない（`month`をキーとするオブジェクト）。 content: application/json: examples: Limit too large: summary: limit=2000000 value: - limit must not exceed 1000000. Offset too large: summary: offset=2000000 value: - offset must not exceed 1000000. Malformed month: summary: month=2026-13 value: month: - Not a calendar month. Use YYYY-MM. schema: oneOf: - type: array items: type: string - type: object properties: month: type: array items: type: string '401': description: >- スコープ付きAPIキーの有効期限が切れています。`401`が返されるのはこの場合のみです。キーが指定されていない場合、無効な場合、または取り消されている場合は`403`が返されます。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 examples: Expired key: summary: キーの有効期限が過ぎています value: detail: This API key has expired. '403': description: >- 認証または認可に失敗しました。キーがない場合、別のアプリケーションのキーの場合、このエンドポイントに必要な権限を持たないスコープ付きキーの場合、キーのIP許可リスト外からのリクエストの場合は`403`を返し、誤った、失効した、または期限切れのキーの場合は`401`を返します。`detail`で区別してください。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 examples: Missing or invalid credentials: summary: x-api-keyヘッダーがないか、キーの検証に失敗しました value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: セッションとは別のアプリケーションに属する有効なキー value: detail: You do not have permission to perform this action. Scoped key without decisions read: summary: 'スコープ付きキーにdecisions: read権限がない' value: detail: This API key has no read access to decisions. IP not allowed: summary: キーのIP許可リスト外からのリクエスト value: detail: This API key can't be used from this IP address. '404': description: >- セッションが存在しない、削除されている、またはスコープ付きキーの制限外であるか、（指定された`node_id`について）AMLチェックがありません。セッションの照会は認証情報の確認より前に行われるため、有効なキーがなくても、不明な`sessionId`には`404`が返されます。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 examples: Unknown session: summary: このIDのセッションが存在しないか、削除されています value: detail: Not found. Outside key limits: summary: セッションがスコープ付きキーの制限外です（直前に削除されたセッションにも返されます） value: detail: Session not found. No AML check: summary: セッションでAMLステップが実行されていません value: detail: The session does not have an AML check. No AML check for node: summary: node_idがセッションのAMLチェックと一致しない value: detail: >- The session does not have an AML check for node 'feature_aml_2'. '429': description: >- レート制限を超過しました。GETリクエストはAPIキーごとに1分あたり600件までです。`Retry-After`秒待ってから再試行してください。`X-RateLimit-*`ヘッダーで利用枠を確認できます。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 examples: Rate limited: summary: 現在の1分間の上限を使い切りました value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: 再試行までに待機する秒数。 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/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.sessions.list_aml_screening_history( "11111111-2222-3333-4444-555555555555", ): print(item) - lang: javascript label: Node.js source: >- 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); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Sessions.ListAMLScreeningHistoryAutoPaging(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SessionsListAMLScreeningHistoryParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- 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); } - lang: php label: PHP source: >- sessions->listAmlScreeningHistory('11111111-2222-3333-4444-555555555555') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.sessions.list_aml_screening_history("11111111-2222-3333-4444-555555555555").auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: >- 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)); } components: schemas: AMLScreeningRun: type: object description: AMLチェックに対して完了した、継続的なモニタリングによる再スクリーニング1件。 required: - uuid - run_id - completed_at - started_at - outcome - trigger - provider - status - score - total_hits - new_hits - entities_screened - dataset_freshness properties: uuid: type: string format: uuid description: このスクリーニング実行の識別子。 run_id: type: string format: uuid description: このスクリーニングが属するモニタリング実行です。同じ実行でスクリーニングされたすべての認証がこの値を共有します。 completed_at: type: string format: date-time description: この対象者の再スクリーニングが完了した日時。結果はこの日時の新しい順に並びます。 started_at: type: string format: date-time description: この再スクリーニングが属するモニタリングバッチが開始された日時。 outcome: type: string enum: - NO_CHANGE - CHANGED - FAILED description: >- `NO_CHANGE`：完了し、結果に変化はありませんでした。`CHANGED`：完了し、スコア、ステータス、ヒット数、またはヒットが変化しました。`FAILED`：この対象について有効な回答が得られなかったため、チェックは変更されずそのままです。 trigger: type: string enum: - ONGOING_MONITORING description: スクリーニングを開始したトリガーです。現時点では常に`ONGOING_MONITORING`です。 provider: type: string description: 応答したAMLデータソースの不透明な識別子です。不透明な文字列として扱い、この値で処理を分岐させないでください。 example: aml_data_source status: type: string nullable: true enum: - Not Finished - Approved - Declined - In Review - Resub Requested - null description: この実行によってAMLチェックが置かれたステータス。 score: type: number format: float nullable: true minimum: 0 maximum: 100 description: この実行によってAMLチェックに設定されたスコア。 total_hits: type: integer nullable: true description: この実行後にチェックに残ったヒットの数。 new_hits: type: integer nullable: true description: >- この実行で見つかった、チェックにそれまでなかったヒットの数。新たなヒットがない場合は`0`、実行が失敗した場合、またはこのカウントが導入される前に記録された場合は`null`です。 entities_screened: type: integer minimum: 0 maximum: 1 description: >- この実行で当該認証のためにスクリーニングされたエンティティの数。対象者がスクリーニングされた場合は`1`、実行が失敗した場合は`0`です。 dataset_freshness: allOf: - $ref: '#/components/schemas/AMLDatasetFreshness' nullable: true description: この実行の基となったデータセットの鮮度。日付が取得できなかった場合は`null`です。 AMLDatasetFreshness: type: object description: スクリーニング実行時点でのAMLデータセットの鮮度です。日付が推定されることはありません。 required: - captured_at - provider - catalog_version - sources properties: captured_at: type: string format: date-time description: この鮮度情報の元となるデータセットカタログをDiditが読み取った日時です。 provider: type: string description: AMLデータソースの不透明な識別子です。不透明な文字列として扱い、この値で処理を分岐させないでください。 example: aml_data_source catalog_version: type: string nullable: true description: データセットカタログのバージョン識別子(ソースが報告する場合)。 sources: type: object description: データセットファミリーごとの鮮度。データセットが更新日を報告していないファミリーは、`null`で埋められるのではなく省略されます。 properties: sanctions: $ref: '#/components/schemas/AMLDatasetSourceFreshness' pep: $ref: '#/components/schemas/AMLDatasetSourceFreshness' warnings: $ref: '#/components/schemas/AMLDatasetSourceFreshness' adverse_media: $ref: '#/components/schemas/AMLDatasetSourceFreshness' AMLDatasetSourceFreshness: type: object description: AMLデータセットの1ファミリーの鮮度。 required: - last_updated_at - oldest_updated_at - dataset_count - dated_dataset_count properties: last_updated_at: type: string format: date-time description: ファミリー内のいずれかのデータセットの直近の更新。 oldest_updated_at: type: string format: date-time nullable: true description: >- 鮮度の上限: ファミリー内のすべてのデータセットは、少なくともこの時点まで最新です。ファミリー内の少なくとも1つのデータセットが更新日を報告していない場合は上限が不明となるため、`null`になります。 dataset_count: type: integer description: ファミリー内のデータセット数。 dated_dataset_count: type: integer description: それらのデータセットのうち、更新日を報告したものの数です。 securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.