> ## 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 عبر واجهة برمجة التطبيقات > اعرض كل عملية إعادة فحص في مراقبة AML المستمرة لجلسة في Didit، بما فيها التي لم يتغير فيها شيء، مع النتيجة والدرجة وحداثة قائمة العقوبات. موجّه واجهة برمجة التطبيقات لسرد سجل فحص AML نسخ الموجّه إلى الحافظة 
  \`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/ar/core-technology/aml-screening/continuous-monitoring-aml-screening.md) كيفية إجراء عمليات إعادة الفحص ومعنى كل حقل. ولتسليم السجل نفسه إلى مدقق في شكل ملف، استخدم [تصدير سجل فحص AML](https://docs.didit.me/ar/management-api/sessions/export-aml-screening-history.md). ## OpenAPI ````yaml ar/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؛ مرّر `node_id` إذا نفذت الجلسة أكثر من خطوة AML واحدة. يتم سرد عمليات إعادة الفحص الخاصة بالمراقبة المستمرة فقط (عملية الفحص الأولى هي جزء من قرار الجلسة) ولا تتم إعادة بناء عمليات التشغيل السابقة لإنشاء هذا السجل، لذلك تُرجع الجلسة التي ليس بها مراقبة مستمرة قائمة فارغة. قيمة `count` دقيقة حتى 100 ويتم تحديد سقف لها عند 100 لما يزيد عن ذلك، لذا اتبع `next` حتى تصبح `null`. مرّر `month` لقراءة شهر تقويمي واحد في كل مرة. يتطلب مفتاح API محدد النطاق إذن `decisions: read`؛ راجع [مراقبة AML المستمرة](https://docs.didit.me/ar/core-technology/aml-screening/continuous-monitoring-aml-screening). operationId: get_v3_session_aml_screening_history parameters: - name: sessionId in: path required: true description: >- معرّف UUID لجلسة التحقق (`session_id` الذي تم إرجاعه بواسطة `POST /v3/session/`). يقبل معرّفات جلسات التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB): يطابق الخادم المعرّف عبر كلا نوعي الجلسات. يجب أن يكون UUID صالح البنية؛ تؤدي القيمة غير صالحة البنية إلى عدم مطابقة المسار وإرجاع `404` بتنسيق HTML. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- معرّف عقدة مخطط سير العمل لفحص AML. مطلوب فقط عندما تُجري الجلسة أكثر من خطوة AML واحدة؛ بدونه يتم استخدام أحدث فحص AML. يُرجع الاستدعاء `404` عند تحديد عقدة غير معروفة. schema: type: string example: feature_aml_1 - name: month in: query required: false description: >- شهر تقويمي بتوقيت UTC بصيغة `YYYY-MM`. يتم إرجاع عمليات الفحص المكتملة في ذلك الشهر فقط؛ ومن دونه يتم إرجاع كل شهر. يُرجع الشهر غير الصالح `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`. يُفضّل تتبّع عناوين URL في `next` و`previous`. 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 المسموح بها للمفتاح؛ بينما يؤدي المفتاح الخاطئ أو الملغى أو منتهي الصلاحية إلى إرجاع `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: لا توجد جلسة بهذا المعرّف، أو أنها حُذفت 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: >- تم تجاوز حد المعدل: 600 طلب GET في الدقيقة لكل مفتاح API. انتظر لعدد الثواني المحدد في `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 الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.