> ## 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. # API Kesegaran Dataset AML > Cek seberapa mutakhir dataset sanksi, PEP, peringatan, dan media negatif Didit per keluarga sumber, sebagai bukti audit untuk pemantauan AML. Prompt API Kemutakhiran Dataset AML Salin prompt ke papan klip \

\`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.`

\
Tempel ke Gunakan endpoint ini untuk menampilkan versi daftar yang digunakan oleh pemantauan berkelanjutan untuk melakukan skrining. Pasangkan dengan riwayat skrining per subjek yang dijelaskan di [Membuktikan bahwa pemantauan berjalan](https://docs.didit.me/id/core-technology/aml-screening/continuous-monitoring-aml-screening.md#membuktikan-bahwa-pemantauan-berjalan): riwayat tersebut menunjukkan kapan setiap subjek menjalani skrining, sedangkan endpoint ini menunjukkan seberapa mutakhir dataset yang digunakan untuk skrining tersebut.> [!NOTE] > > Tanggal yang hilang dilaporkan sebagai hilang, tidak pernah digantikan dengan nilai pengganti. Periksa `availability` terlebih dahulu: jika nilainya bukan `available`, `dataset_freshness` bernilai `null` dan tidak ada yang dapat dibaca.## Terkait- [Pemantauan AML berkelanjutan](https://docs.didit.me/id/core-technology/aml-screening/continuous-monitoring-aml-screening.md) - [API skrining AML](https://docs.didit.me/id/standalone-apis/aml-screening.md) - [Kunci API dan akses dengan cakupan terbatas](https://docs.didit.me/id/console/api-keys.md) ## OpenAPI ````yaml id/openapi-25.json GET /v3/aml/dataset-freshness/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/aml/dataset-freshness/: get: tags: - Standalone APIs summary: Dapatkan keterkinian himpunan data AML description: >- Laporkan seberapa mutakhir set data di balik Skrining AML, per kelompok sumber (`sanctions`, `pep`, `warnings`, `adverse_media`), sebagai bukti audit untuk [Pemantauan AML Berkelanjutan](https://docs.didit.me/id/core-technology/aml-screening/continuous-monitoring-aml-screening#membuktikan-bahwa-pemantauan-berjalan). Jawabannya berlaku untuk seluruh platform: tidak ada sesi di path, tidak ada data pelanggan di body, jawaban yang sama untuk setiap aplikasi. Selalu `200` untuk kunci yang diterima. Periksa `availability` terlebih dahulu: jika nilainya bukan `available`, `dataset_freshness` bernilai `null`. Tanggal tidak pernah diestimasi: kelompok yang set datanya tidak melaporkan tanggal tidak akan ada di `sources`, dan kelompok yang hanya beberapa set datanya melaporkan tanggal memiliki `oldest_updated_at: null`. Pembacaan diambil saat pemantauan berkelanjutan berjalan, bukan pada setiap panggilan; `captured_at` menyatakan waktunya. Kunci API dengan cakupan memerlukan `sessions: read`; kunci yang terbatas pada beberapa alur kerja atau pada sesi yang disetujui tidak dapat memanggil endpoint ini. Tidak ada yang ditagihkan. operationId: get_aml_dataset_freshness parameters: [] responses: '200': description: >- Pembacaan terbaru terkait kebaruan set data, atau `null` beserta alasannya. content: application/json: schema: type: object required: - dataset_freshness - availability properties: dataset_freshness: allOf: - $ref: '#/components/schemas/AMLDatasetFreshness' nullable: true description: >- Pembacaan terbaru, atau `null` saat `availability` bukan `available`. availability: type: string enum: - available - not_configured - not_yet_collected description: >- `available` ketika pembacaan ada; `not_configured` ketika tanggal dataset tidak dikumpulkan di lingkungan ini; `not_yet_collected` ketika pengumpulan telah disiapkan tetapi belum ada pembacaan. 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: >- Kunci API telah kedaluwarsa. Hanya kunci yang dibuat dengan tanggal kedaluwarsa yang dapat kedaluwarsa; setelah tanggal tersebut, setiap permintaan dengannya menghasilkan respons `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- Permintaan tidak diizinkan. Kunci yang tidak ada akan mendapatkan pesan umum; kunci yang salah, dicabut, atau kedaluwarsa akan mendapatkan `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: >- Lebih dari 600 permintaan GET per menit dengan kunci API ini. Tunggu selama jumlah detik di `Retry-After`, lalu coba lagi. 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: Detik hingga jendela satu menit saat ini direset. schema: type: integer example: 23 X-RateLimit-Limit: description: Permintaan yang diizinkan per menit dalam anggaran ini. schema: type: integer X-RateLimit-Remaining: description: Permintaan tersisa dalam jendela saat ini. schema: type: integer X-RateLimit-Reset: description: Waktu Unix saat jendela direset. 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: >- Tingkat kemutakhiran set data AML saat skrining dijalankan. Tanggal tidak pernah diestimasi. required: - captured_at - provider - catalog_version - sources properties: captured_at: type: string format: date-time description: >- Waktu ketika Didit membaca katalog dataset yang menjadi sumber informasi kesegaran ini. provider: type: string description: >- Pengidentifikasi tidak transparan dari sumber data AML. Perlakukan sebagai string yang tidak transparan; jangan membuat percabangan logika berdasarkan nilai ini. example: aml_data_source catalog_version: type: string nullable: true description: >- Pengidentifikasi versi dari katalog dataset, jika sumber melaporkannya. sources: type: object description: >- Kebaruan per kelompok himpunan data. Kelompok yang himpunan datanya tidak melaporkan tanggal pembaruan tidak ditampilkan, alih-alih diisi dengan `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: Kebaruan dari satu kelompok dataset AML. required: - last_updated_at - oldest_updated_at - dataset_count - dated_dataset_count properties: last_updated_at: type: string format: date-time description: >- Pembaruan terbaru dari himpunan data apa pun dalam keluarga tersebut. oldest_updated_at: type: string format: date-time nullable: true description: >- Batas keusangan: setiap himpunan data dalam keluarga setidaknya semutakhir ini. `null` jika setidaknya satu himpunan data dalam keluarga tidak melaporkan tanggal pembaruan, karena batasnya menjadi tidak diketahui. dataset_count: type: integer description: Jumlah dataset dalam keluarga. dated_dataset_count: type: integer description: Jumlah himpunan data yang melaporkan tanggal pembaruan. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.