> ## 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의 제재, PEP, 경고, 부정적 언론 보도 데이터셋이 소스 계열별로 얼마나 최신인지 AML 모니터링 감사 증거로 확인합니다. AML 데이터셋 최신성 API 프롬프트 프롬프트를 클립보드에 복사 \

\`Read how current Didit's AML screening datasets are, so I can attach it to an audit of ongoing AML monitoring.

Endpoint:
GET https://verification.didit.me/v3/aml/dataset-freshness/

Authentication:
Use the x-api-key header with my Didit API key. A scoped key needs sessions: read. A key limited to some workflows or to approved sessions can't call this endpoint.

Goal:
\- Get, per AML source family (sanctions, pep, warnings, adverse_media), the most recent dataset update and the staleness bound, and store it next to the AML screening history I hand to an auditor.

Behavior:
\- Platform-wide: no session in the path, no customer data in the answer, the same answer for every application.
\- Always 200. When no reading exists, dataset_freshness is null and availability says why: "not_configured" (dataset dates are not collected in this environment) or "not_yet_collected" (collection is set up, no reading yet).
\- Dates are never estimated. A family whose datasets reported no date is absent from sources. A family where only some datasets reported a date has oldest_updated_at: null.
\- captured_at is when the dates were read. Readings are taken while ongoing monitoring runs, not on each call.

Example call:
curl -X GET "https://verification.didit.me/v3/aml/dataset-freshness/" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- availability - "available", "not_configured" or "not_yet_collected". Check it before reading dataset_freshness.
\- dataset_freshness.captured_at - when the reading was taken.
\- dataset_freshness.sources..last_updated_at - the most recent update in that family.
\- dataset_freshness.sources..oldest_updated_at - every dataset in the family is at least this current; null when some dates are missing.
\- dataset_freshness.sources..dataset_count and dated_dataset_count - how many datasets the family has and how many reported a date.
\- dataset_freshness.catalog_version - the data source's own catalog version, when reported.

Failure modes:
\- 401 - the API key has expired.
\- 403 - missing key (a wrong, revoked or expired key gets 401) ({"detail": "You do not have permission to perform this action."}), a scoped key without sessions: read, a key limited to workflows or approved sessions, or a request from outside the key's IP list.
\- 429 - more than 600 GET requests per minute with this key; wait Retry-After seconds.

Side effects: none. Not billed.

For the full integration shape, see /integration/integration-prompt.`

\
붙여넣을 곳 이 엔드포인트를 사용하면 지속적인 모니터링이 어떤 목록 버전을 기준으로 스크리닝을 수행했는지 확인할 수 있습니다. [모니터링 실행 증명](https://docs.didit.me/ko/core-technology/aml-screening/continuous-monitoring-aml-screening.md#모니터링-실행-입증)에서 설명하는 대상별 스크리닝 기록과 함께 사용하세요. 기록에는 각 대상이 언제 스크리닝되었는지가 나오고, 이 엔드포인트에서는 해당 스크리닝의 기반이 된 데이터셋이 얼마나 최신인지 확인할 수 있습니다.> [!NOTE] > > 누락된 날짜는 누락된 것으로 보고되며, 다른 값으로 대체되지 않습니다. 먼저 `availability`를 확인하세요. 값이 `available`이 아니면 `dataset_freshness`는 `null`이며 읽을 내용이 없습니다.## 관련 문서- [지속적인 AML 모니터링](https://docs.didit.me/ko/core-technology/aml-screening/continuous-monitoring-aml-screening.md) - [AML 스크리닝 API](https://docs.didit.me/ko/standalone-apis/aml-screening.md) - [API 키 및 범위 지정 액세스](https://docs.didit.me/ko/console/api-keys.md) ## OpenAPI ````yaml ko/openapi-25.json GET /v3/aml/dataset-freshness/ 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/aml/dataset-freshness/: get: tags: - Standalone APIs summary: AML 데이터 세트 최신 상태 조회 description: >- [지속적인 AML 모니터링](https://docs.didit.me/ko/core-technology/aml-screening/continuous-monitoring-aml-screening#모니터링-실행-입증)의 감사 증거로서 AML 스크리닝의 기반이 되는 데이터세트가 얼마나 최신인지 소스 패밀리(`sanctions`, `pep`, `warnings`, `adverse_media`)별로 보고합니다. 응답은 플랫폼 전반에 적용됩니다. 경로에 세션이 없고 본문에 고객 데이터가 없으며 모든 애플리케이션에 동일한 응답이 제공됩니다. 수락된 키의 경우 항상 `200`입니다. 먼저 `availability`를 확인하십시오. `available`이 아니면 `dataset_freshness`는 `null`입니다. 날짜는 절대 추정되지 않습니다. 데이터세트에 날짜가 보고되지 않은 패밀리는 `sources`에서 제외되며, 일부 데이터세트에서만 날짜가 보고된 패밀리는 `oldest_updated_at: null`이 됩니다. 측정값은 각 호출 시점이 아니라 지속적인 모니터링이 실행되는 동안 수집되며, `captured_at`에 수집 시점이 표시됩니다. 범위가 지정된 API 키에는 `sessions: read`가 필요하며, 일부 워크플로나 승인된 세션으로 제한된 키는 이 endpoint를 호출할 수 없습니다. 요금은 청구되지 않습니다. operationId: get_aml_dataset_freshness parameters: [] responses: '200': description: 최신 데이터 세트의 최신성 측정값 또는 이유와 함께 `null`입니다. content: application/json: schema: type: object required: - dataset_freshness - availability properties: dataset_freshness: allOf: - $ref: '#/components/schemas/AMLDatasetFreshness' nullable: true description: 최신 측정값 또는 `availability`가 `available`이 아닐 때 `null`입니다. availability: type: string enum: - available - not_configured - not_yet_collected description: >- 측정값이 있는 경우 `available`, 이 환경에서 데이터셋 날짜를 수집하지 않는 경우 `not_configured`, 수집이 설정되었지만 아직 측정값이 없는 경우 `not_yet_collected`입니다. examples: Available: value: dataset_freshness: captured_at: '2026-10-17T06:00:12.345678+00:00' provider: aml_data_source catalog_version: 20261017054500-abc sources: sanctions: last_updated_at: '2026-10-17T04:10:00+00:00' oldest_updated_at: '2026-10-15T22:30:00+00:00' dataset_count: 48 dated_dataset_count: 48 pep: last_updated_at: '2026-10-16T23:05:00+00:00' oldest_updated_at: null dataset_count: 12 dated_dataset_count: 11 availability: available Not collected yet: value: dataset_freshness: null availability: not_yet_collected '401': description: >- API 키가 만료되었습니다. 만료일이 지정되어 생성된 키만 만료될 수 있으며, 해당 날짜 이후에는 이를 사용한 모든 요청에 `401`이 반환됩니다. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- 요청이 허용되지 않습니다. 키가 누락된 경우 일반 메시지가 반환되며, 잘못되거나 취소되었거나 만료된 키는 `401`을 받습니다. content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid key: value: detail: You do not have permission to perform this action. Scoped key without sessions read: value: detail: This API key has no read access to sessions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. Outside the key's IP list: value: detail: This API key can't be used from this IP address. '429': description: >- 이 API 키로 분당 600건을 초과하는 GET 요청이 발생했습니다. `Retry-After`에 명시된 시간(초)만큼 대기한 후 다시 시도하세요. content: application/json: schema: type: object properties: detail: type: string examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: 현재 1분 기간이 초기화될 때까지 남은 시간(초)입니다. schema: type: integer example: 23 X-RateLimit-Limit: description: 이 예산에서 분당 허용되는 요청 수입니다. schema: type: integer X-RateLimit-Remaining: description: 현재 윈도우에 남은 요청 수입니다. schema: type: integer X-RateLimit-Reset: description: 윈도우가 리셋되는 Unix 시간입니다. schema: type: integer security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/aml/dataset-freshness/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.aml.retrieve_dataset_freshness() print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.aml.retrieveDatasetFreshness(); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.AML.RetrieveDatasetFreshness(ctx)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.aml().retrieveDatasetFreshness(); System.out.println(result); - lang: php label: PHP source: |- aml->retrieveDatasetFreshness(); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.aml.retrieve_dataset_freshness puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Aml.RetrieveDatasetFreshnessAsync(); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: 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 데이터 세트의 최신성입니다. 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: >- 데이터 최신성 경계: 제품군의 모든 데이터셋은 최소한 이 시점만큼 최신 상태입니다. 제품군의 하나 이상의 데이터셋에 업데이트 날짜가 보고되지 않아 경계를 알 수 없는 경우 `null`입니다. dataset_count: type: integer description: 패밀리 내 데이터셋 수입니다. dated_dataset_count: type: integer description: 업데이트 날짜를 보고한 해당 데이터 세트의 수입니다. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.