> ## 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. # قائمة مراجعات الجلسات: سجل تدقيق KYC > استرجع كل ملاحظة مراجعة يدوية وكل تغيير في الحالة لجلسة التحقق من Didit. سجل امتثال جاهز للتدقيق، بالدفع لكل استدعاء، دون عقود. موجّه سرد مراجعات الجلسات نسخ الموجّه إلى الحافظة \

\``Goal: Fetch the full review/activity feed for a Didit verification session — manual comments, status changes, KYC/KYB edits, file uploads, AML events, tags. Mirrors the timeline shown on the Console session-detail page.

Endpoint: GET https://verification.didit.me/v3/sessions/{session_id}/reviews/
Auth header: x-api-key: YOUR_API_KEY

Path param:
\- session_id (UUID, REQUIRED) — verification session UUID. Cross-application reads return 404.

curl:
curl -s 'https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/' \
-H "x-api-key: $DIDIT_API_KEY"

Response 200: JSON ARRAY (no envelope, no pagination — feed is bounded). Newest first. Each entry (ReviewItem) has:
\- uuid (UUID)
\- activity_type: "COMMENT" | "STATUS_UPDATED" | "KYC_DATA_UPDATED" | "POA_DATA_UPDATED" | "FILE_ADDED" | "FILE_REMOVED" | "AML_ONGOING_MATCH" | "AML_STATUS_UPDATED" | "AML_HIT_STATUS_UPDATED" | "KYB_DATA_UPDATED" | "KYB_DOCUMENT_UPLOADED" | "TAG_ADDED" | "TAG_REMOVED"
\- actor_email, actor_display, actor_type: "API_KEY" | "CONSOLE_USER" | "SYSTEM"
\- new_status, previous_status — only populated for STATUS_UPDATED/AML_STATUS_UPDATED. Values from the SESSION status enum: "Not Started" | "In Progress" | "Awaiting User" | "In Review" | "Approved" | "Declined" | "Resubmitted" | "Expired" | "Kyc Expired" | "Abandoned".
\- comment (string | null)
\- mentioned_emails (string[]) — extracted @mentions, only for COMMENT activities
\- previous_value, new_value, changed_fields — diff payload for *_DATA_UPDATED, FILE_*, TAG_* (opaque JSON, shape varies per activity_type)
\- metadata (object | null)
\- created_at (ISO 8601 UTC)
Empty array means the session has had no recorded activity yet.

When to use:
\- Render an audit trail mirror on your own dashboard.
\- Export the feed for compliance archives.
\- Poll for manual-review decisions when you can't consume webhooks (filter activity_type === "STATUS_UPDATED"; inspect new_status). Webhooks are still preferred — see /integration/webhooks.

Failure modes (envelope {"detail": "..."}):
\- 401 — missing/invalid `x-api-key` header. Re-fetch your application API key from the Auth API if needed.
\- 403 — API key valid but the application is not allowed (revoked, expired, or wrong app).
\- 404 — session UUID does not exist, has been deleted, or belongs to a different application.
\- 429 — rate-limited. Inspect Retry-After.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.``

\
الصق في ## OpenAPI ````yaml ar/openapi-25.json GET /v3/sessions/{session_id}/reviews/ 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/sessions/{session_id}/reviews/: get: tags: - Sessions summary: عرض مراجعات الجلسة وسجل النشاط description: >- إرجاع مسار التدقيق / سجل النشاط لجلسة التحقق من المستخدمين (KYC)، من الأحدث إلى الأقدم، ضمن غلاف مقسّم لصفحات (`count` / `next` / `previous` / `results`، بواقع 50 مدخلاً لكل صفحة افتراضياً). تُكتب مدخلات السجل بواسطة كل طرف يتعامل مع الجلسة: القرارات اليدوية المتخذة عبر `PATCH /v3/session/{session_id}/update-status/` (والتي تسجل `previous_status` → `new_status`)، ونشاط المراجِع في Console (التعليقات مع إشارات `@email`، وتعديلات بيانات KYC/POA، وتحميلات/عمليات إزالة الملفات، وتغييرات الوسوم، وعرض صفحة التفاصيل)، وتطابقات مراقبة AML المستمرة، والملاحظات الملحقة عبر `POST` على نفس هذا المسار. قراءة هذا السجل تعادل من جانب API لوحة **Activity** في عرض الجلسة على Didit Console. جلسات التحقق من المستخدمين (KYC) فقط هي القابلة للوصول هنا؛ وتُرجع معرّفات جلسات التحقق من الشركات (KYB) الرمز `404`. operationId: list_session_reviews parameters: - name: session_id in: path required: true description: >- معرّف UUID لجلسة التحقق من المستخدمين (KYC). يجب أن تنتمي إلى التطبيق نفسه الخاص بمفتاح API — تُرجع معرّفات UUID من تطبيقات أخرى والجلسات المحذوفة ومعرّفات جلسات التحقق من الشركات (KYB) الرمز `404`. schema: type: string format: uuid example: 8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d - name: limit in: query required: false description: حجم الصفحة. القيمة الافتراضية `50`. schema: type: integer default: 50 example: 50 - name: offset in: query required: false description: >- عدد الإدخالات المراد تخطيها من بداية الخلاصة (المرتبة). القيمة الافتراضية هي `0`. يحتوي رابطا `next` / `previous` في الاستجابة على القيم الصحيحة للتنقل في الخلاصة. schema: type: integer default: 0 example: 0 - name: ordering in: query required: false description: >- ترتيب الفرز. يعتمد الموجز افتراضياً الأحدث أولاً (`-created_at`)؛ قم بتمرير `created_at` لقراءته من الأقدم أولاً. يتم تجاهل القيم غير المعروفة دون إشعار (يُستخدم الترتيب الافتراضي)؛ كما تُقبل أسماء حقول serializer الأخرى أيضاً. schema: type: string default: '-created_at' example: created_at responses: '200': description: >- موجز نشاط مقسم إلى صفحات، الأحدث أولاً بشكل افتراضي. `count` هو إجمالي عدد المدخلات؛ و`next` / `previous` هما رابطا URL جاهزان للصفحات (`null` عند الأطراف). تعني قيمة `count` البالغة `0` مع `results` فارغة أنه لم يُسجَّل أي نشاط بعد. content: application/json: schema: type: object properties: count: type: integer description: >- العدد الإجمالي لإدخالات الخلاصة لهذه الجلسة (عبر جميع الصفحات). example: 3 next: type: string nullable: true description: رابط URL للصفحة التالية، أو `null` في الصفحة الأخيرة. example: null previous: type: string nullable: true description: رابط URL للصفحة السابقة، أو `null` في الصفحة الأولى. example: null results: type: array items: $ref: '#/components/schemas/ReviewItem' description: إدخالات الموجز لهذه الصفحة. examples: DecisionTrail: summary: موافقة يدوية بالإضافة إلى ملاحظات مضافة عبر API value: count: 3 next: null previous: null results: - uuid: de0561bc-5583-4409-9171-1a31a4c8a5f4 activity_type: STATUS_UPDATED actor_display: API Client actor_email: null actor_type: API_KEY new_status: Approved previous_status: In Review comment: Document re-checked manually; address matches. mentioned_emails: [] previous_value: status: In Review new_value: status: Approved changed_fields: - status metadata: null created_at: '2026-06-12T00:19:31.918735Z' - uuid: 35370f58-5098-44ee-8a06-8c9af80b2455 activity_type: STATUS_UPDATED actor_display: Unknown actor_email: null actor_type: CONSOLE_USER new_status: null previous_status: null comment: Note without status. mentioned_emails: [] previous_value: null new_value: null changed_fields: [] metadata: null created_at: '2026-06-12T00:18:44.504157Z' - uuid: 00338f82-f1c5-4f57-8614-c49bb258af1a activity_type: STATUS_UPDATED actor_display: Unknown actor_email: null actor_type: CONSOLE_USER new_status: In Review previous_status: null comment: Flagging for manual document re-check. mentioned_emails: [] previous_value: null new_value: null changed_fields: [] metadata: null created_at: '2026-06-12T00:18:44.466537Z' PaginatedFirstPage: summary: الصفحة الأولى مع limit=2 — تحتوي next على رابط المتابعة value: count: 4 next: >- https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/?limit=2&offset=2 previous: null results: - uuid: de0561bc-5583-4409-9171-1a31a4c8a5f4 activity_type: STATUS_UPDATED actor_display: API Client actor_email: null actor_type: API_KEY new_status: Approved previous_status: In Review comment: Document re-checked manually; address matches. mentioned_emails: [] previous_value: status: In Review new_value: status: Approved changed_fields: - status metadata: null created_at: '2026-06-12T00:19:31.918735Z' - uuid: bd4e6227-bdd2-42b2-a726-1d12f785a457 activity_type: STATUS_UPDATED actor_display: Unknown actor_email: null actor_type: CONSOLE_USER new_status: null previous_status: null comment: null mentioned_emails: [] previous_value: null new_value: null changed_fields: [] metadata: null created_at: '2026-06-12T00:18:44.540238Z' Empty: summary: جلسة ليس لها نشاط مسجل بعد value: count: 0 next: null previous: null results: [] '403': description: >- رمز `x-api-key` مفقود أو مشوه أو منتهي الصلاحية أو ملغى. يتم التحقق من المصادقة قبل البحث عن الجلسة، لذلك يعيد المفتاح المفقود `403` حتى في حال عدم وجود UUID للجلسة. content: application/json: schema: type: object properties: detail: type: string example: You do not have permission to perform this action. examples: InvalidKey: summary: رأس x-api-key مفقود أو غير صالح value: detail: You do not have permission to perform this action. '404': description: >- لا توجد جلسة تحقق من المستخدمين (KYC) بهذا الـ UUID مرئية لتطبيقك: إما أن الـ UUID غير موجود، أو تم حذف الجلسة، أو أنها تنتمي إلى تطبيق مختلف. كما تُرجع معرّفات جلسات التحقق من الشركات (KYB) رمز `404` هنا — موجز المراجعات مخصص لجلسات KYC فقط. content: application/json: schema: type: object properties: detail: type: string example: Session not found. examples: NotFound: summary: ‏UUID لجلسة غير معروف، أو محذوف، أو تابع لتطبيق آخر value: detail: Session not found. '429': description: >- تم تجاوز حد المعدل. تحقق من رؤوس الاستجابة `Retry-After` و`X-RateLimit-*`. راجع [تحديد المعدل](/ar/integration/rate-limiting). security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -s 'https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/?limit=50' \ -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.reviews.list( "8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d", ): 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.reviews.list("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d")) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Sessions.Reviews.ListAutoPaging(ctx, \"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d\", didit.SessionsReviewsListParams{})\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().reviews().list("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d")) { System.out.println(item); } - lang: php label: PHP source: >- sessions->reviews->list('8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.sessions.reviews.list("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d").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.Reviews.ListAsync("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d")) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: ReviewItem: type: object description: >- إدخال واحد في سجل مراجعة الجلسة / موجز النشاط. تتضمن تغييرات الحالة `previous_status` و`new_status` و`previous_value` و`new_value` و`changed_fields`؛ وتتضمن التعليقات `comment` و(بالنسبة لتعليقات وحدة التحكم) `mentioned_emails`؛ وتكون الحقول المتبقية `null` أو فارغة عندما لا تنطبق على نوع النشاط. properties: uuid: type: string format: uuid description: المعرّف الفريد لمدخل الخلاصة هذا. example: de0561bc-5583-4409-9171-1a31a4c8a5f4 activity_type: type: string enum: - COMMENT - STATUS_UPDATED - KYC_DATA_UPDATED - POA_DATA_UPDATED - FILE_ADDED - FILE_REMOVED - AML_ONGOING_MATCH - AML_STATUS_UPDATED - AML_HIT_STATUS_UPDATED - KYB_DATA_UPDATED - KYB_DOCUMENT_UPLOADED - TAG_ADDED - TAG_REMOVED - FEATURE_OVERRIDE_PENDING - FEATURE_OVERRIDE_APPLIED - FEATURE_OVERRIDE_CANCELLED description: >- نوع النشاط الذي يسجله هذا الإدخال. تأتي صفوف `STATUS_UPDATED` من القرارات اليدوية (`PATCH /v3/session/{session_id}/update-status/`) ومن الإدخالات المضافة عبر `POST …/reviews/` (والتي يتم تعيينها افتراضياً إلى هذا النوع حتى عند عدم تسجيل أي حالة). تأتي صفوف `COMMENT` من مراجعي Console؛ كما يتم تخزين مشاهدات صفحة التفاصيل في Console كصفوف `COMMENT` مميزة بـ `metadata.system_event = "DETAIL_VIEWED"`. تتبع الأنواع المتبقية تعديلات البيانات وتغييرات الملفات والعلامات ونشاط مراقبة AML. تتم كتابة صفوف STATUS_UPDATED أيضاً بواسطة جهات تابعة للنظام (مثل مراقبة AML المستمرة مع actor_type SYSTEM، والتحديثات التلقائية لحالة الميزات)، وليس فقط عبر endpoint تحديث الحالة ومنشورات المراجعة اليدوية. تسجل `FEATURE_OVERRIDE_PENDING` و `FEATURE_OVERRIDE_APPLIED` و `FEATURE_OVERRIDE_CANCELLED` تجاوزاً لحالة فحص واحد (`PATCH /v3/session/{session_id}/features/{node_id}/update-status/`): سواء كان مطلوباً للانتظار حتى انتهاء سير العمل، أو تم تطبيقه، أو تم إلغاؤه. وهي تحمل حالة الفحص في `previous_value` / `new_value` (`{"status": ...}`)، وتترك `previous_status` و `new_status` بقيمة `null`، وتحدد التجاوز في `metadata` (`feature_override_id`، `node_id`، `feature_model`، `forced`، `state`، `cancel_reason`). يحمل الإدخال الخاص بالطلب تعليق المراجِع في `comment`؛ ويتم تسجيل التجاوز المطبق عند انتهاء سير العمل مع `actor_type` بقيمة `SYSTEM`. example: STATUS_UPDATED actor_display: type: string description: >- تسمية كاتب سهلة القراءة، يتم حلها بهذا الترتيب: الاسم الكامل للفاعل ← معرّف حساب Console ← الجزء المحلي من `actor_email` ← `"API Client"` (للفاعلين من نوع `API_KEY`) ← `"System"` (للفاعلين من نوع `SYSTEM`) ← `"Unknown"`. تعرض الإدخالات التي تم إنشاؤها عبر `POST …/reviews/` دائماً `"Unknown"` لأن هذا الـ endpoint لا يسجل إسناداً للفاعل. example: API Client actor_email: type: string nullable: true description: >- البريد الإلكتروني لمستخدم Console الذي نفّذ الإجراء. يكون `null` للجهات الفاعلة عبر مفتاح API والنظام. example: null actor_type: type: string enum: - API_KEY - CONSOLE_USER - SYSTEM description: >- من نفّذ الإجراء: مفتاح API، أو مستخدم لوحة التحكم، أو Didit نفسها (`SYSTEM`، مثل مراقبة AML المستمرة). الإدخالات التي تم إنشاؤها عبر `POST …/reviews/` تحمل القيمة الافتراضية `CONSOLE_USER` بغض النظر عن الجهة التي أجرت الاستدعاء. example: API_KEY new_status: type: string nullable: true enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User description: >- حالة الجلسة المسجلة بواسطة هذا الإدخال (لتحديثات الحالة). `null` للتعليقات وإدخالات تغيير البيانات. example: Approved previous_status: type: string nullable: true enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User description: >- الحالة التي كانت عليها الجلسة قبل التغيير. يتم ملؤها في مدخلات `STATUS_UPDATED` المكتوبة بواسطة endpoint تحديث الحالة؛ وتكون `null` في المدخلات المضافة عبر `POST …/reviews/`. يتم ملؤها أيضاً في صفوف STATUS_UPDATED المكتوبة بواسطة النظام. example: In Review comment: type: string nullable: true description: ملاحظة بنص حر مرفقة بالإدخال، أو `null`. example: Document re-checked manually; address matches. mentioned_emails: type: array items: type: string format: email description: >- مستخدمو Console المُشار إليهم عبر `@email` في التعليق. يكون فارغاً دائماً للإدخالات التي تم إنشاؤها عبر واجهة API هذه — حيث تعد معالجة الإشارة ميزة خاصة بـ Console فقط. example: [] previous_value: type: object nullable: true description: >- لقطة للبيانات المعدلة قبل الإجراء، على سبيل المثال `{"status": "In Review"}` عند تغيير الحالة. تكون `null` عندما لم يتغير شيء. example: status: In Review new_value: type: object nullable: true description: >- لقطة للبيانات المعدلة بعد الإجراء، على سبيل المثال `{"status": "Approved"}`. تكون `null` عندما لم يتغير شيء. example: status: Approved changed_fields: type: array items: type: string description: >- أسماء الحقول التي تم تعديلها بواسطة هذا النشاط (مثل `["status"]`). تكون فارغة للتعليقات وللإدخالات المضافة عبر `POST …/reviews/`. example: - status metadata: type: object nullable: true description: >- سياق إضافي للمدخلات المنشأة بواسطة النظام. تحمل عمليات عرض صفحة التفاصيل في Console القيمة `{"system_event": "DETAIL_VIEWED", "detail_type": "verification"}` بحيث يمكن استبعادها عبر التصفية من منطق الإشعارات. يحمل أي `COMMENT` قام كاتبه بتعديله في Console الحقل `edited_at`، وهو وقت آخر تعديل بتنسيق ISO 8601 (ويحتوي `comment` و`mentioned_emails` حينئذٍ على النص المعدل والإشارات المذكورة فيه). ويكون `null` للمدخلات العادية. example: null created_at: type: string format: date-time description: وقت كتابة المُدخل، بتنسيق ISO 8601 UTC. example: '2026-06-12T00:19:31.918735Z' 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.