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

\`Retrieve a single fraud network's full detail through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.

Path parameter:
\- network_uuid - the network's UUID, from list networks.

Response 200: NetworkDetailResponse. Everything in the list-item shape (uuid, network_id, name, status, risk, pattern_types, signal_types, member_counts, member_status, signal_coverage, first_activity_at, last_activity_at), plus stats, fraud_tags, risk_signals (residential_proxy_reuse, email_intelligence, phone_intelligence summaries), reviewed_at, reviewed_by, review_reason, notes_count, and:
\- sharing_mode, cross_org_available, cross_org_unavailable_reason: the same fields as on list networks. sharing_mode is off|private|global (only global compares networks across organizations). cross_org_available is true only with the Enterprise plan and global sharing. cross_org_unavailable_reason is plan (checked first), sharing_mode, or null when available.
\- tags: my application's tags on the network, oldest first. Each is {uuid, name, color, source (didit|custom), added_by (the console member's email, or null when an API key added it), added_at}. Each application sees only its own tags. fraud_tags is separate and unchanged: the tags the network's members carry.
\- outcomes: {approved, declined, in_review, total}. Each member I may see counts once, by the status of their most recent verification that reached a decision. total counts members with at least one verification; a member whose verifications are all undecided counts only in total. Transaction parties are not counted.
\- patterns: [{type: "background", score, members, reason, computed_at}]. score is 0 to 1 with 4 decimals: the mean similarity of every pair of member selfie backgrounds, the person masked out. It reads the newest selfie of each person (at most the 50 newest, age assurance sessions excluded) across the whole network, not only my applications.
\- reason "computing": score, members and computed_at are null; read the network again later.
\- reason "not_enough_selfies": fewer than two members have a usable selfie; score is null and members is 0 or 1.
\- reason null: score is set, members is how many selfies were compared, computed_at is when.

Failure modes:
\- 404: {"detail": "Network not found."}. The network does not exist, or has no member visible to this application.
\- 401: missing or invalid x-api-key.
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs read:networks.
\- 403 with {"code": "networks_not_entitled"}: Networks is not enabled for the organization.

Side effects: the network does not change. A read that finds no current background score schedules its computation.

For the full integration shape, see /integration/integration-prompt.`

\
الصق في استرجع شبكة واحدة مع كل ما يلزم لعرض لوحة نظرة عامة على الشبكة: تفصيل المخاطر، ووسوم الاحتيال المكتشفة، وملخصات إشارات المخاطر، إلى جانب الحقول المشتركة مع القائمة. يتضمن التفصيل أيضًا وسوم تطبيقك على الشبكة، وحالة عمليات التحقق الخاصة بأعضائها، ومدى تشابه خلفيات صور السيلفي الخاصة بهم.## الوسوميسرد `tags` وسوم تطبيقك على الشبكة، من الأقدم إلى الأحدث. لا يرى كل تطبيق إلا وسومه الخاصة ولا يعدّل إلا وسومه الخاصة. يكون `added_by` البريد الإلكتروني لعضو وحدة التحكم الذي أضاف الوسم، أو `null` عندما يكون مفتاح API هو من أضافه. استخدم [إضافة وسم إلى شبكة](https://docs.didit.me/ar/management-api/networks/add-tag.md) و[إزالة وسم من شبكة](https://docs.didit.me/ar/management-api/networks/remove-tag.md) لتغييرها. أما `fraud_tags` فلم يتغير: إذ يسرد الوسوم التي يحملها أعضاء الشبكة.## نتائج الأعضاءيحسب `outcomes` عدد الأشخاص والشركات الذين قد تراهم في الشبكة، مع احتساب كل واحد منهم مرة واحدة.| المفتاح | ما الذي يحسبه | | - | - | | `approved` | الأعضاء الذين كانت آخر عملية تحقق محسومة لهم مقبولة | | `declined` | الأعضاء الذين كانت آخر عملية تحقق محسومة لهم مرفوضة | | `in_review` | الأعضاء الذين تقف آخر عملية تحقق محسومة لهم قيد المراجعة | | `total` | الأعضاء الذين لديهم عملية تحقق واحدة على الأقل، محسومة كانت أو غير محسومة |يُحتسب العضو الذي رُفض ثم قُبل لاحقًا بعد إعادة المحاولة ضمن `approved`. أما العضو الذي تكون كل عمليات التحقق الخاصة به غير محسومة (لم تبدأ، أو قيد التنفيذ، أو منتهية الصلاحية، أو متروكة) فيُحتسب ضمن `total` فقط. لا تخضع أطراف المعاملات لأي عملية تحقق، ولذلك لا تُحتسب.## نمط خلفية صورة السيلفييحتوي `patterns` حاليًا على عنصر واحد، وقيمة `type` فيه هي `background`. يمثل `score`، وهو قيمة من 0 إلى 1، متوسط التشابه بين كل زوج من خلفيات صور السيلفي للأعضاء، مع إخفاء الشخص في الصورة. تشير القيمة القريبة من 1 إلى أن صور السيلفي التُقطت في المكان نفسه. وقد تحصل الجدران السادة ذات الألوان المتشابهة على درجة مرتفعة أيضًا، لذا تعامل مع الدرجة بوصفها دليلًا يستحق المراجعة، لا إثباتًا. تقرأ الدرجة أحدث صورة سيلفي لكل شخص، بحد أقصاه أحدث 50 صورة، وتستثني جلسات التحقق من العمر. وتشمل الدرجة الشبكة كلها، لا أعضاء تطبيقاتك فقط.| `reason` | `score` | `members` | ما الذي يجب فعله | | - | - | - | - | | `null` | من 0 إلى 1 | عدد صور السيلفي التي جرت مقارنتها | استخدم الدرجة. يوضح `computed_at` وقت حسابها. | | `computing` | `null` | `null` | يجري حساب الدرجة للأعضاء الحاليين. اقرأ الشبكة مرة أخرى لاحقًا. | | `not_enough_selfies` | `null` | `0` أو `1` | لدى أقل من عضوين صور سيلفي صالحة للاستخدام. |لا تُقارن صورة السيلفي التي لا يمكن قراءتها، أو التي تُظهر خلفية قليلة جدًا، ولهذا قد يكون `members` أقل من عدد الأشخاص في الشبكة. تصف الدرجة دائمًا صور السيلفي الحالية للأعضاء. وعندما يتغير الأعضاء، مثلًا عند انضمام عضو أو مغادرته، يعرض التفصيل القيمة `computing` إلى أن تصبح الدرجة الجديدة جاهزة، أو القيمة `not_enough_selfies` إذا بقي أقل من عضوين.## التوفر عبر المؤسساتيتضمن التفصيل القيم نفسها `sharing_mode` و`cross_org_available` و`cross_org_unavailable_reason` الموجودة في [سرد الشبكات](https://docs.didit.me/ar/management-api/networks/list.md#وضع-المشاركة-والإشارات-عبر-المؤسسات). تحتاج الإشارات عبر المؤسسات إلى خطة Enterprise ووضع المشاركة `global` معًا.## مواضيع ذات صلة- [سرد الشبكات](https://docs.didit.me/ar/management-api/networks/list.md) - [إضافة وسم إلى شبكة](https://docs.didit.me/ar/management-api/networks/add-tag.md) - [إزالة وسم من شبكة](https://docs.didit.me/ar/management-api/networks/remove-tag.md) - [أعضاء الشبكة](https://docs.didit.me/ar/management-api/networks/members.md) - [مخطط الشبكة](https://docs.didit.me/ar/management-api/networks/graph.md) ## OpenAPI ````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/ 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/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/: get: tags: - Networks summary: الحصول على الشبكة description: >- استرداد التفاصيل الكاملة لشبكة واحدة: الإحصاءات وعلامات الاحتيال وإشارات المخاطر، بالإضافة إلى `sharing_mode` الخاص بالمؤسسة والتوفر عبر المؤسسات، و`tags` الخاصة بتطبيقك على الشبكة، و`outcomes` للأعضاء ودرجات الأنماط (`patterns`). يتطلب مفتاح API ذا وصول كامل، أو إذن `read:networks` لعضو في لوحة التحكم. operationId: get_network parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID الخاص بالمؤسسة. - name: application_id in: path required: true schema: type: string format: uuid description: معرّف UUID للتطبيق. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: معرّف UUID للشبكة. responses: '200': description: تفاصيل الشبكة. content: application/json: schema: $ref: '#/components/schemas/NetworkDetailResponse' example: uuid: 3fa85f64-5717-4562-b3fc-2c963f66afa6 network_id: N-0042 name: null status: in_review risk: score: 82 band: high bar: 0.82 pattern_types: - exact_same_device - same_email signal_types: - device - email member_counts: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signal_coverage: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 first_activity_at: '2026-10-01T09:12:44Z' last_activity_at: '2026-10-12T16:03:10Z' stats: members: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signals: total: 2 by_type: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 fraud_tags: [] risk_signals: residential_proxy_reuse: detected: false signal_count: 0 max_subject_count: 0 email_intelligence: enriched_signal_count: 1 high_risk_count: 0 social_profile_count: 0 phone_intelligence: enriched_signal_count: 0 high_risk_count: 0 reviewed_at: '2026-10-12T16:30:00Z' reviewed_by: reviewer@example.com review_reason: Shared device across three new accounts. notes_count: 0 sharing_mode: global cross_org_available: true cross_org_unavailable_reason: null tags: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' outcomes: approved: 1 declined: 1 in_review: 0 total: 3 patterns: - type: background score: 0.8125 members: 3 reason: null computed_at: '2026-10-13T08:00:00Z' '401': description: بيانات اعتماد مفقودة أو غير صالحة. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- موجود في الأخطاء ذات الرموز، على سبيل المثال `networks_not_entitled`. examples: Missing or invalid credentials: summary: بيانات اعتماد مفقودة أو غير صالحة value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- ينتمي مفتاح API إلى تطبيق آخر، أو أنه مفتاح ذو وصول مقيد: تتطلب endpoint الخاصة بـ Networks مفتاحاً كامل الوصول. يتطلب token عضو لوحة التحكم إذن `read:networks`. يتم إرجاعه أيضاً مع `code: networks_not_entitled` عندما لا تكون Networks مفعّلة للمؤسسة. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- موجود في الأخطاء ذات الرموز، على سبيل المثال `networks_not_entitled`. examples: Networks not enabled: summary: الشبكات غير مفعّلة value: detail: >- Networks is disabled for this organization. Contact Didit support if you believe this is an error. code: networks_not_entitled Restricted API key: summary: مفتاح API مقيد value: detail: This API key has no access to this endpoint. No permission: summary: لا يوجد إذن value: detail: You do not have permission to perform this action. '404': description: لم يتم العثور على الشبكة (أو أنها غير مرئية لهذا التطبيق). content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.networks.retrieve( "n3a5e000-0000-4000-8000-000000000001", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Networks.Retrieve(ctx, \"n3a5e000-0000-4000-8000-000000000001\")\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_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieve('n3a5e000-0000-4000-8000-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkDetailResponse: description: >- تفاصيل الشبكة، بالإضافة إلى وضع المشاركة الخاص بالمؤسسة، وما إذا كانت الإشارات المشتركة بين المؤسسات تنطبق عليها، وعلامات تطبيقك على الشبكة، ونتائج الأعضاء، ودرجات الأنماط. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- وضع المشاركة بين المؤسسات الخاص بالمؤسسة. تقارن القيمة `global` فقط الشبكات عبر المؤسسات؛ بينما تقصر القيمتان `private` و`off` المقارنة على سجل المؤسسة الخاص فقط. example: global cross_org_available: type: boolean description: >- ما إذا كانت الإشارات المشتركة بين المؤسسات تسري على هذه المؤسسة. تتطلب كلاً من خطة Enterprise ووضع المشاركة `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- سبب عدم تطبيق الإشارات المشتركة بين المؤسسات، ويتم التحقق منها بهذا الترتيب. `plan`: خطة المؤسسة لا تتضمن شبكة مكافحة الاحتيال المشتركة بين المؤسسات (تتطلب خطة Enterprise)، أياً كان وضع المشاركة. `sharing_mode`: تتضمن الخطة الميزة، لكن وضع المشاركة هو `private` أو `off`. تكون Null عندما تكون قيمة `cross_org_available` هي `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- علامات تطبيقك على الشبكة، الأقدم أولاً. يرى كل تطبيق علاماته الخاصة فقط. `fraud_tags` منفصلة ولم تتغير: العلامات التي يحملها أعضاء الشبكة. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: درجات الأنماط عبر الشبكة بأكملها. عنصر واحد اليوم، `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: إحصائيات مجمعة للشبكة (مثل إجمالي الأعضاء). fraud_tags: type: array items: type: object description: وسوم أنماط الاحتيال التي ظهرت على الشبكة. risk_signals: type: object description: >- ملخصات إشارات المخاطر: residential_proxy_reuse، وemail_intelligence، وphone_intelligence. reviewed_at: type: string format: date-time nullable: true reviewed_by: type: string nullable: true review_reason: type: string nullable: true properties: notes_count: type: integer minimum: 0 readOnly: true description: عدد ملاحظات المحلل الخاصة في هذا التحقيق. NetworkTag: type: object description: إحدى علامات تطبيقك على الشبكة. properties: uuid: type: string format: uuid description: معرّف UUID الخاص بالوسم، وهو نفس القيمة التي تمررها كـ `tag_uuid`. name: type: string color: type: string description: لون سداسي عشري، على سبيل المثال `#6366F1`. source: type: string enum: - didit - custom description: '`didit` لعلامة مسبقة الضبط من Didit، و`custom` لعلامة أنشأها فريقك.' added_by: type: string nullable: true description: >- البريد الإلكتروني لعضو وحدة التحكم الذي أضاف الوسم. يكون Null عندما يضيفه مفتاح API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- حالة الأفراد والشركات في الشبكة. يُحسب كل عضو مسموح لك برؤيته مرة واحدة، استناداً إلى حالة أحدث عملية تحقق له انتهت باتخاذ قرار. ولا يتم احتساب أطراف المعاملات. properties: approved: type: integer description: الأعضاء الذين كانت آخر عملية تحقق تم البت فيها خاصة بهم مقبولة. declined: type: integer description: الأعضاء الذين كانت آخر عملية تحقق تم البت فيها خاصة بهم مرفوضة. in_review: type: integer description: >- الأعضاء الذين تكون آخر عملية تحقق تم البت فيها خاصة بهم قيد المراجعة. total: type: integer description: >- الأعضاء الذين لديهم عملية تحقق واحدة على الأقل، سواء تم البت فيها أم لا. العضو الذي تكون جميع عمليات التحقق الخاصة به غير محسومة (لم تبدأ، أو قيد التنفيذ، أو منتهية الصلاحية، أو متروكة) يُحسب هنا ولا يُحسب في أي مفتاح آخر. NetworkPatternScore: type: object description: >- مدى تشابه أحد أنواع بيانات الأعضاء عبر الشبكة بأكملها. النمط ليس إشارة: لا توجد قيمة مشتركة تربط الأعضاء. properties: type: type: string enum: - background description: >- `background`: متوسط التشابه لكل زوج من خلفيات صور السيلفي للأعضاء، مع حجب الشخص. يقرأ أحدث صورة سيلفي لكل شخص، بحد أقصى أحدث 50 صورة، ويستبعد جلسات تأكيد العمر. يغطي الشبكة بالكامل، وليس فقط أعضاء تطبيقاتك. score: type: number nullable: true minimum: 0 maximum: 1 description: من 0 إلى 1، مقرباً إلى 4 منازل عشرية. يكون Null عند تعيين `reason`. members: type: integer nullable: true description: >- عدد صور السيلفي للأعضاء التي قارنتها الدرجة. لا تتم مقارنة صورة السيلفي التي لا يمكن قراءتها، أو التي تظهر خلفية غير كافية. تكون القيمة فارغة Null أثناء حالة `computing`؛ و0 أو 1 مع `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- سبب عدم وجود درجة. `computing`: يجري احتساب الدرجة للأعضاء الحاليين؛ أعد قراءة الشبكة لاحقاً. `not_enough_selfies`: أقل من عضوين لديهما صورة سيلفي قابلة للاستخدام. تكون القيمة Null عند توفر درجة. computed_at: type: string format: date-time nullable: true description: متى تم احتساب الدرجة. وتكون Null أثناء `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: معرّف تسلسلي مقروء للبشر لكل مؤسسة، مثل N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- حالة دورة حياة الشبكة. تختلف عن outcome_status لكل مقدم طلب داخل الشبكة (approved/in_review/declined/not_completed). risk: $ref: '#/components/schemas/NetworkRiskDisplay' pattern_types: type: array items: type: string enum: - exact_same_device - similar_device - same_ip_address - same_address - similar_selfie_backgrounds - similar_poa_documents - same_document_number - same_phone_number - same_email description: أنماط التجميع المكتشفة في هذه الشبكة. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: أنواع الإشارات المميزة الموجودة في هذه الشبكة. member_counts: type: object description: أعداد الأعضاء حسب الفئة (مثل الإجمالي، ولكل outcome_status). member_status: type: object description: تفصيل الأعضاء حسب outcome_status. signal_coverage: type: object description: تغطية أعضاء هذه الشبكة لكل signal_type. first_activity_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true NetworkRiskDisplay: type: object properties: score: type: integer description: درجة المخاطر، من 0 إلى 100. band: type: string enum: - low - medium - high description: >- النطاق الذي تظهر فيه الدرجة. high >= 70، وmedium >= 40، وخلاف ذلك low. bar: type: number format: float description: قيمة معيارية من 0 إلى 1 لعرض شريط المخاطر. 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.