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

\`List the check (feature) status overrides of a Didit session: the ones that applied, the ones still waiting for the person to finish the flow, and the cancelled ones.

Endpoint:
GET https://verification.didit.me/v3/session/{session_id}/features/overrides/

Authentication:
x-api-key (client API key) or a user-auth token. Privilege: read:sessions. A scoped API key needs read access to decisions.

Path parameter:
\- session_id (UUID): KYC or KYB; Didit resolves it against both session types.

Response (200, not paginated):
\- session_id (UUID).
\- person_in_flow (boolean): true while the person is still in the flow, so a new override with defer_until_flow_finishes=true would wait.
\- flow_finished_at (date-time or null): when the person last finished the flow. null while they are still in it (a resubmission included) and when the session closed before they finished.
\- overrides (array, newest first). Each override:
\- id (UUID): pass it to the cancel endpoint.
\- node_id, feature_type ("" when the request passed none), feature_model (for example "KYC", "Face", "AML").
\- previous_status, new_status.
\- state: "applied", "pending_until_flow_finishes" or "cancelled".
\- forced (boolean): true when it applied at once while the person was still in the flow.
\- reason: the comment sent with the request, or null.
\- requested_by: { email, name, type } with type "CONSOLE_USER", "API_KEY" or "SYSTEM"; or null.
\- requested_at, applied_at (null while waiting or once cancelled), cancelled_at.
\- cancel_reason: null, "cancelled_by_reviewer", "replaced", "check_changed" or "session_closed".

curl example:
curl https://verification.didit.me/v3/session//features/overrides/ \
-H "x-api-key: "

Failure modes:
\- 401: the scoped API key has expired.
\- 403: missing credentials (a wrong, revoked or expired key gets 401), the caller lacks read:sessions, a scoped key lacks decisions read, or the session belongs to another application ({ "detail": "You do not have permission to perform this action." }).
\- 404: { "detail": "Not found." } when no session with this session_id exists.

Related: create overrides with PATCH /v3/session/{session_id}/features/{node_id}/update-status/ (see /sessions-api/update-feature-status); cancel a waiting one with POST /v3/session/{session_id}/features/overrides/{override_id}/cancel/ (see /sessions-api/cancel-feature-override).

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

\
الصق في يسجّل كل استدعاء لـ[تحديث حالة الميزة](https://docs.didit.me/ar/sessions-api/update-feature-status.md) تجاوزًا لحالة فحص واحد. يسرد هذا endpoint كل التجاوزات الخاصة بجلسة واحدة، من الأحدث إلى الأقدم، دون تقسيم إلى صفحات.## حالات التجاوز| `state` | المعنى | | - | - | | `applied` | يحمل الفحص الحالة الجديدة. يحدد `applied_at` وقت ذلك. | | `pending_until_flow_finishes` | ينتظر التجاوز، ويُطبَّق عندما ينهي الشخص التدفق. | | `cancelled` | انتظر التجاوز ولم يُطبَّق أبدًا. يوضح `cancel_reason` السبب. |طُبّق التجاوز الذي يحمل `forced: true` فورًا، والشخص ما زال في التدفق.## سبب إلغاء تجاوز في الانتظار| `cancel_reason` | ما الذي حدث | | - | - | | `cancelled_by_reviewer` | ألغاه شخص باستخدام [إلغاء تجاوز الميزة](https://docs.didit.me/ar/sessions-api/cancel-feature-override.md). | | `replaced` | حلّ محلّه تجاوز أحدث على الفحص نفسه. | | `check_changed` | أعاد الشخص الفحص قبل إنهاء التدفق، فلم تعد النتيجة التي تجاوزتها موجودة. | | `session_closed` | خرجت الجلسة من التدفق قبل أن ينهيه الشخص: متروكة، أو منتهية الصلاحية، أو اتُّخذ القرار بشأنها أثناء التدفق. |## أين يقع الشخص في التدفقتكون `person_in_flow` بقيمة `true` طالما كانت الجلسة في حالة `Not Started` أو `In Progress` أو `Resubmitted` ولم ينهِ الشخص التدفق. وطالما كانت القيمة `true`، ينتظر أي تجاوز جديد يحمل `defer_until_flow_finishes: true`. يحدد `flow_finished_at` وقت آخر مرة أنهى فيها الشخص التدفق. تكون القيمة `null` طالما ما زال الشخص في التدفق، بما في ذلك إعادة التقديم، وعندما تُغلق الجلسة قبل أن ينهيه الشخص.## ذات صلة- [تحديث حالة الميزة](https://docs.didit.me/ar/sessions-api/update-feature-status.md): تجاوز حالة خطوة واحدة، الآن أو بعد انتهاء التدفق. - [إلغاء تجاوز الميزة](https://docs.didit.me/ar/sessions-api/cancel-feature-override.md): أوقف تجاوزًا في الانتظار حتى لا يُطبَّق. - [استرجاع الجلسة](https://docs.didit.me/ar/sessions-api/retrieve-session.md): `node_id` لكل ميزة والحالة الحالية لها. ## OpenAPI ````yaml ar/openapi-25.json GET /v3/session/{sessionId}/features/overrides/ 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}/features/overrides/: get: tags: - Sessions summary: سرد عمليات تجاوز الفحص للجلسة description: >- كل تجاوز لحالة ميزة (خطوة) فردية في جلسة التحقق من المستخدمين (KYC) أو التحقق من الشركات (KYB)، الأحدث أولاً وبدون تقسيم صفحات: التجاوزات المطبقة، وتلك التي تنتظر إنهاء الشخص لسير العمل (`pending_until_flow_finishes`)، والملغاة، وكل منها يوضح من طلبها، والسبب، وما إذا كانت قد طُبقت بينما كان الشخص لا يزال في سير العمل (`forced`). يوضح لك `person_in_flow` ما إذا كان التجاوز الجديد باستخدام `defer_until_flow_finishes: true` سينتظر. ويوضح `flow_finished_at` آخر مرة أنهى فيها الشخص سير العمل؛ وتكون قيمته `null` بينما لا يزال فيه (بما في ذلك إعادة الإرسال) وعندما أُغلقت الجلسة قبل أن ينتهي. يتطلب صلاحية `read:sessions`؛ ويحتاج مفتاح API محدود النطاق إلى وصول للقراءة إلى القرارات. operationId: get_v3_session_feature_overrides parameters: - in: path name: sessionId required: true description: >- معرّف UUID لجلسة التحقق. يقبل معرّفات جلسات المستخدمين (KYC) والشركات (KYB). schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 responses: '200': description: تجاوزات الفحص الخاصة بالجلسة، الأحدث أولاً. content: application/json: schema: type: object required: - session_id - person_in_flow - flow_finished_at - overrides properties: session_id: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 person_in_flow: type: boolean description: >- ما إذا كان الشخص لا يزال في المسار، بحيث ينتظر التجاوز الجديد مع `defer_until_flow_finishes: true`. example: true flow_finished_at: type: string format: date-time nullable: true description: >- متى أنهى الشخص التدفق آخر مرة. وتكون `null` طالما أنه لا يزال بداخله (بما في ذلك إعادة التقديم) وعندما أُغلقت الجلسة قبل أن يُنهيه (متروكة أو منتهية الصلاحية أو تم اتخاذ قرار في منتصف التدفق). example: null overrides: type: array description: كل تجاوز للجلسة، الأحدث أولاً. items: $ref: '#/components/schemas/FeatureStatusOverride' examples: Overrides: summary: تجاوز واحد قيد الانتظار، وتجاوز واحد مُطبّق value: session_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 person_in_flow: true flow_finished_at: null overrides: - id: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3 node_id: feature_liveness_1 feature_type: '' feature_model: Face previous_status: Declined new_status: Approved state: pending_until_flow_finishes forced: false reason: Liveness retried with a reviewer present. requested_by: email: reviewer@example.com name: Alex Reviewer type: CONSOLE_USER requested_at: '2026-10-13T09:15:00Z' applied_at: null cancelled_at: null cancel_reason: null - id: 7c9e6679-7425-40de-944b-e07fc1f90ae7 node_id: feature_ocr_1 feature_type: '' feature_model: KYC previous_status: In Review new_status: Approved state: applied forced: true reason: Document manually verified by compliance. requested_by: email: reviewer@example.com name: Alex Reviewer type: CONSOLE_USER requested_at: '2026-10-13T09:15:00Z' applied_at: '2026-10-13T09:15:00Z' cancelled_at: null cancel_reason: null '401': description: انتهت صلاحية مفتاح API محدد النطاق. content: application/json: examples: Expired API Key: summary: مفتاح API محدد النطاق تجاوز تاريخ انتهاء صلاحيته value: detail: This API key has expired. '403': description: >- بيانات اعتماد مفقودة، أو جهة مستدعية تفتقر إلى امتياز `read:sessions`، أو مفتاح API ذو نطاق محدد لا يمتلك الوصول الذي يتطلبه هذا الـ endpoint، أو `session_id` ينتمي إلى تطبيق آخر. content: application/json: examples: Invalid Credentials: summary: x-api-key مفقود أو غير صالح value: detail: >- Authentication credentials were not provided or are invalid. Missing Privilege: summary: المستدعي يفتقر إلى read:sessions value: detail: You do not have permission to perform this action. Scoped Key Without Access: summary: مفتاح API محدد النطاق دون صلاحية الوصول هذه value: detail: This API key has no read access to decisions. '404': description: لا توجد جلسة KYC أو KYB بمعرّف `session_id` هذا. content: application/json: examples: Not Found: summary: session_id غير معروف value: detail: Not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X GET \ https://verification.didit.me/v3/session/3fa85f64-5717-4562-b3fc-2c963f66afa6/features/overrides/ \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.list_feature_overrides( "3fa85f64-5717-4562-b3fc-2c963f66afa6", ) 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.sessions.listFeatureOverrides("3fa85f64-5717-4562-b3fc-2c963f66afa6"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.ListFeatureOverrides(ctx, \"3fa85f64-5717-4562-b3fc-2c963f66afa6\")\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.sessions().listFeatureOverrides("3fa85f64-5717-4562-b3fc-2c963f66afa6"); System.out.println(result); - lang: php label: PHP source: >- sessions->listFeatureOverrides('3fa85f64-5717-4562-b3fc-2c963f66afa6'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.list_feature_overrides("3fa85f64-5717-4562-b3fc-2c963f66afa6") 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.Sessions.ListFeatureOverridesAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: FeatureStatusOverride: type: object description: >- تجاوز واحد لحالة فحص (ميزة) تم إجراؤه باستخدام `PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/`: ما يغيّره، وما إذا كان قد طُبّق أم لا يزال بانتظار إنهاء الشخص لسير العمل، ومن طلبه وسبب ذلك. required: - id - node_id - feature_type - feature_model - previous_status - new_status - state - forced - reason - requested_by - requested_at - applied_at - cancelled_at - cancel_reason properties: id: type: string format: uuid description: معرّف التجاوز. مرّره إلى endpoint الإلغاء. example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 node_id: type: string description: عقدة سير العمل المحددة في الطلب (`default` لخطوة بدون عقدة). example: feature_ocr_1 feature_type: type: string description: >- قيمة `feature_type` التي مررها الطلب، أو سلسلة فارغة في حال لم يمرر أي قيمة. example: '' feature_model: type: string description: >- نوع الفحص الذي تم تجاوزه، على سبيل المثال `KYC` أو `Face` أو `AML` أو `GeolocationCheck`. example: KYC previous_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: حالة الفحص عند طلب التجاوز. example: In Review new_status: type: string enum: - Approved - Declined - In Review description: الحالة التي يحددها التجاوز. example: Approved state: type: string enum: - applied - pending_until_flow_finishes - cancelled description: >- `applied`: أصبحت حالة الفحص الجديدة. `pending_until_flow_finishes`: ينتظر التجاوز ويُطبّق عندما ينهي الشخص سير العمل. `cancelled`: انتظر ولم يُطبّق أبدًا (راجع `cancel_reason`). example: applied forced: type: boolean description: >- تكون `true` عندما يتم تطبيق التجاوز فوراً بينما لا يزال الشخص في مسار التحقق. example: false reason: type: string nullable: true description: قيمة `comment` المرسلة مع الطلب، أو `null`. example: Document manually verified by compliance. requested_by: type: object nullable: true description: من طلب التجاوز، أو `null` عندما لا يكون ذلك معروفاً. properties: email: type: string format: email nullable: true description: >- البريد الإلكتروني لمستخدم وحدة التحكم، أو `null` لمفاتيح API والنظام. example: reviewer@example.com name: type: string nullable: true description: اسم العرض لمقدّم الطلب، أو `null`. example: Alex Reviewer type: type: string enum: - CONSOLE_USER - API_KEY - SYSTEM description: 'من أجرى الطلب: مستخدم لوحة التحكم، أو مفتاح API، أو Didit نفسها.' example: CONSOLE_USER requested_at: type: string format: date-time description: متى تم طلب التجاوز. example: '2026-10-13T09:15:00Z' applied_at: type: string format: date-time nullable: true description: >- وقت اتخاذ الفحص للحالة الجديدة، أو `null` أثناء انتظاره أو بعد إلغائه. example: '2026-10-13T09:15:00Z' cancelled_at: type: string format: date-time nullable: true description: وقت إلغاء تجاوز الانتظار، أو `null`. example: null cancel_reason: type: string nullable: true enum: - cancelled_by_reviewer - replaced - check_changed - session_closed - null description: >- سبب عدم تطبيق التجاوز قيد الانتظار نهائياً، أو `null`. `cancelled_by_reviewer`: أُلغي بواسطة endpoint الإلغاء. `replaced`: حل محله تجاوز أحدث على الفحص نفسه. `check_changed`: أعاد الشخص إجراء الفحص قبل إنهاء سير العمل. `session_closed`: غادرت الجلسة سير العمل قبل أن يُنهيه الشخص (متروكة، أو منتهية الصلاحية، أو تم اتخاذ القرار أثناء سير العمل). example: null 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.