> ## 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 के साथ किसी सत्र की हर सतत 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/hi/core-technology/aml-screening/continuous-monitoring-aml-screening.md) बताता है कि पुनः स्क्रीनिंग कैसे की जाती है और हर फ़ील्ड का क्या अर्थ है। इसी इतिहास को फ़ाइल के रूप में ऑडिटर को देने के लिए, [AML स्क्रीनिंग इतिहास एक्सपोर्ट करें](https://docs.didit.me/hi/management-api/sessions/export-aml-screening-history.md) का उपयोग करें। ## OpenAPI ````yaml hi/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` के अनुसार नवीनतम पहले, जिसमें वे रन भी शामिल हैं जहां कुछ भी नहीं बदला: अलर्ट, गतिविधि प्रविष्टियां और webhooks केवल तभी ट्रिगर होते हैं जब कोई परिणाम बदलता है, इसलिए यह इतिहास इस बात का प्रमाण है कि जिस विषय पर कोई प्रतिकूल परिणाम नहीं मिला था, उसकी अभी भी स्क्रीनिंग की जा रही थी। यह KYC और KYB सत्र ID के लिए काम करता है; जब सत्र में एक से अधिक AML चरण चलाए गए हों तो `node_id` पास करें। केवल सतत निगरानी पुनः-स्क्रीन ही सूचीबद्ध होते हैं (पहली स्क्रीनिंग सत्र निर्णय का हिस्सा होती है) और इस इतिहास के मौजूद होने से पहले के रन पुनर्निर्मित नहीं किए जाते हैं, इसलिए बिना सतत निगरानी वाला सत्र एक खाली सूची लौटाता है। `count` 100 तक सटीक है और उसके ऊपर 100 पर सीमित है, इसलिए `next` का तब तक अनुसरण करें जब तक कि यह `null` न हो जाए। एक समय में एक कैलेंडर माह पढ़ने के लिए `month` पास करें। स्कोप्ड API कुंजी के लिए `decisions: read` की आवश्यकता होती है; [सतत AML निगरानी](https://docs.didit.me/hi/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: >- प्रति पेज स्क्रीनिंग रन की अधिकतम संख्या। डिफ़ॉल्ट 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: स्क्रीनिंग रन का एक पेज, सबसे नया पहले। 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 से अधिक है (एक संदेश वाला 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: >- प्रमाणीकरण या प्राधिकरण विफलता। अनुपस्थित कुंजी `403` लौटाती है, और किसी अन्य एप्लिकेशन की कुंजी, इस endpoint के लिए आवश्यक अनुमति के बिना वाली स्कोप्ड कुंजी, तथा कुंजी की IP अनुमति सूची (allowlist) के बाहर से किया गया अनुरोध भी यही लौटाता है; गलत, निरस्त या समय-सीमा समाप्त कुंजी `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: >- सत्र मौजूद नहीं है, हटा दिया गया था या स्कोप्ड कुंजी की सीमाओं से बाहर है, या इसमें कोई AML जांच नहीं है (दिए गए `node_id` के लिए)। सत्र लुकअप क्रेडेंशियल जांच से पहले चलता है, इसलिए एक अज्ञात `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: >- रेट लिमिट पार हो गई: प्रति API कुंजी प्रति मिनट 600 GET अनुरोध। पुनः प्रयास करने से पहले `Retry-After` सेकंड तक प्रतीक्षा करें; `X-RateLimit-*` हेडर बजट दिखाते हैं। content: application/json: schema: type: object properties: detail: type: string description: मानव-पठनीय त्रुटि संदेश। examples: Rate limited: summary: वर्तमान मिनट का बजट समाप्त हो गया 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 जाँच की एक पूर्ण सतत-निगरानी पुनः स्क्रीनिंग। 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 डेटासेट के एक परिवार की नवीनता। 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: >- आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन 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.