> ## 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. # الحصول على نتيجة فحص الاحتيال > استرجع من Didit نتيجة فحص الاحتيال المحفوظة التي تخص تطبيقك. تُعيد هذه الواجهة النتيجة المخزنة لفحص احتيال يعود إلى تطبيقك. استرجِع فحصًا مكتملًا باستخدام بيانات اعتماد التطبيق نفسه. الاستجابة هي نتيجة التنفيذ المخزّنة، ولا يؤدي الاسترجاع إلى إعادة تشغيل الفحوصات أو تحمّل رسوم إضافية. تنطبق صلاحية المشاركة الحالية على أدلة الشبكة العالمية: بعد سحب الوصول، تُخفى التجميعات المشتركة وأدلة المخاطر المشتقة منها. تُحفظ التوصية التاريخية. يُعيد الفحص غير المعروف أو غير المكتمل أو المحذوف الاستجابة `404`. ويُعيد الفحص التابع لتطبيق آخر الاستجابة `404` أيضًا. ## OpenAPI ````yaml ar/openapi-25.json GET /v3/fraud/checks/{check_id}/ 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/fraud/checks/{check_id}/: get: tags: - Fraud Check summary: استرجاع فحص احتيال description: جلب فحص تم إنشاؤه مسبقًا عبر `check_id` الخاص به. operationId: root_retrieve parameters: - in: path name: check_id schema: type: string format: uuid required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/FraudCheckResponse' description: '' '401': content: application/json: schema: $ref: '#/components/schemas/FraudClientCredentialsErrorMessage' description: '' '403': content: application/json: schema: $ref: >- #/components/schemas/FraudClientCredentialsForbiddenErrorMessage description: '' security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.fraud_checks.retrieve( "11111111-2222-3333-4444-555555555555", ) 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.fraudChecks.retrieve("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.FraudChecks.Retrieve(ctx, \"11111111-2222-3333-4444-555555555555\")\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.fraudChecks().retrieve("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- fraudChecks->retrieve('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.fraud_checks.retrieve("11111111-2222-3333-4444-555555555555") 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.FraudChecks.RetrieveAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: FraudCheckResponse: type: object properties: check_id: type: string format: uuid request_id: type: string format: uuid description: جلسة تحقق أصلية تم إنشاؤها لهذا الفحص. client_reference: type: string nullable: true processing_status: $ref: '#/components/schemas/FraudProcessingStatusEnum' profile_id: type: string profile_version: type: string created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true inputs: type: array items: $ref: '#/components/schemas/FraudCheckInput' modules: type: array items: $ref: '#/components/schemas/FraudCheckModuleReport' attribute_evidence: type: array items: type: object additionalProperties: {} compound_evidence: type: array items: type: object additionalProperties: {} risk: type: array items: $ref: '#/components/schemas/FraudCheckRisk' network: type: object additionalProperties: {} enrichment: type: object additionalProperties: {} identity_relationship: allOf: - $ref: '#/components/schemas/FraudCheckIdentityRelationship' nullable: true recommendation: $ref: '#/components/schemas/FraudRecommendationEnum' next_action: $ref: '#/components/schemas/FraudNextActionEnum' decision_reasons: type: array items: type: string coverage: type: object additionalProperties: {} usage: type: array items: type: object additionalProperties: {} vendor_data: type: string nullable: true metadata: nullable: true required: - attribute_evidence - check_id - client_reference - completed_at - compound_evidence - coverage - created_at - decision_reasons - inputs - modules - network - next_action - processing_status - profile_id - profile_version - recommendation - risk - usage FraudClientCredentialsErrorMessage: type: object properties: detail: type: string default: 'Authentication failed: Invalid client access token.' FraudClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission FraudProcessingStatusEnum: enum: - pending - running - completed - failed type: string description: |- * `pending` - معلق * `running` - قيد التشغيل * `completed` - مكتمل * `failed` - فشل FraudCheckInput: type: object properties: reference: type: string description: مُعرّف مُنقّح للمُعرّف المُرسل. type: $ref: '#/components/schemas/FraudTypeEnum' namespace: type: object additionalProperties: {} quality: type: string normalization: type: object additionalProperties: {} availability: $ref: '#/components/schemas/FraudAvailabilityEnum' required: - availability - namespace - normalization - quality - reference - type FraudCheckModuleReport: type: object properties: module: $ref: '#/components/schemas/FraudExcludeEnum' status: $ref: '#/components/schemas/FraudStatusEnum' reason: type: string nullable: true latency_ms: type: integer freshness: type: string nullable: true billable_units: type: integer required: - billable_units - freshness - latency_ms - module - reason - status FraudCheckRisk: type: object properties: dimension: $ref: '#/components/schemas/FraudDimensionEnum' score: type: integer nullable: true band: $ref: '#/components/schemas/FraudBandEnum' availability: $ref: '#/components/schemas/FraudAvailabilityEnum' requested_but_unavailable: type: boolean description: >- تكون القيمة True عندما يقدّم الطلب كل ما يحتاجه هذا البُعد ولكن المنصة لم تتمكن رغم ذلك من الاستجابة له. لا يُوصى أبداً بالموافقة على مثل هذا الفحص بالاعتماد فقط على الأبعاد التي تمت الاستجابة لها. reason_codes: type: array items: type: string evidence_indexes: type: array items: type: integer required: - availability - band - dimension - evidence_indexes - reason_codes - requested_but_unavailable - score FraudCheckIdentityRelationship: type: object properties: result: $ref: '#/components/schemas/FraudResultEnum' reference_type: type: string country: type: string availability: $ref: '#/components/schemas/FraudAvailabilityEnum' reason_codes: type: array items: type: string required: - availability - country - reason_codes - reference_type - result FraudRecommendationEnum: enum: - approve - review - reject type: string description: |- * `approve` - موافقة * `review` - مراجعة * `reject` - رفض FraudNextActionEnum: enum: - none - manual_review - step_up - resubmit_capture type: string description: |- * `none` - لا شيء * `manual_review` - مراجعة يدوية * `step_up` - تصعيد * `resubmit_capture` - إعادة إرسال الالتقاط FraudTypeEnum: enum: - email - phone - national_id - tax_number - passport_number - driving_licence_number - residence_permit_number - voter_id - external_id type: string description: |- * `email` - البريد الإلكتروني * `phone` - الهاتف * `national_id` - الهوية الوطنية * `tax_number` - الرقم الضريبي * `passport_number` - رقم جواز السفر * `driving_licence_number` - رقم رخصة القيادة * `residence_permit_number` - رقم تصريح الإقامة * `voter_id` - معرّف الناخب * `external_id` - المعرّف الخارجي FraudAvailabilityEnum: enum: - available - not_requested - no_reference - insufficient_history - unsupported_region - source_unavailable type: string description: |- * `available` - متاح * `not_requested` - لم يُطلب * `no_reference` - لا يوجد مرجع * `insufficient_history` - سجل غير كافٍ * `unsupported_region` - منطقة غير مدعومة * `source_unavailable` - المصدر غير متاح FraudExcludeEnum: enum: - normalization - email_risk - email_social - phone_social - phone_risk - ip_risk - database_validation - networks_same_org - networks_cross_org - biometric_identity type: string description: |- * `normalization` - التطبيع * `email_risk` - مخاطر البريد الإلكتروني * `email_social` - الحسابات الاجتماعية للبريد الإلكتروني * `phone_social` - الحسابات الاجتماعية لرقم الهاتف * `phone_risk` - مخاطر رقم الهاتف * `ip_risk` - مخاطر عنوان IP * `database_validation` - التحقق من قواعد البيانات * `networks_same_org` - شبكات المؤسسة نفسها * `networks_cross_org` - شبكات عبر المؤسسات * `biometric_identity` - الهوية البيومترية FraudStatusEnum: enum: - planned - completed - skipped - failed type: string description: |- * `planned` - مخطط لها * `completed` - مكتملة * `skipped` - تم تخطيها * `failed` - فشلت FraudDimensionEnum: enum: - identity - contact - device_network - behavioral - fraud_network type: string description: |- * `identity` - الهوية * `contact` - جهة الاتصال * `device_network` - شبكة الجهاز * `behavioral` - السلوك * `fraud_network` - شبكة الاحتيال FraudBandEnum: enum: - low - medium - high - unknown type: string description: |- * `low` - منخفض * `medium` - متوسط * `high` - مرتفع * `unknown` - غير معروف FraudResultEnum: enum: - match - mismatch - inconclusive - no_reference type: string description: |- * `match` - مطابقة * `mismatch` - عدم تطابق * `inconclusive` - غير حاسم * `no_reference` - لا يوجد مرجع 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. BearerAuth: type: http scheme: bearer description: token الوصول الخاص باعتماد العميل للتطبيق. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.