> ## 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.

# سجل التحقق من الشركات (KYB): الجلسات والتقارير

> استرجع كل جلسات KYB المرتبطة بكيان الشركة في Didit، وافحص بيانات السجل التجاري ونتائج AML، وأعد التحقق، وأنشئ تقارير الامتثال.



موجّه سجل KYB
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\````# Goal — read a business's full KYB history and trigger re-verification

Every KYB session is linked to the Business entity via `vendor_data`. List sessions, retrieve each decision, and create new sessions for re-KYB.

\## List every KYB session for a business

\```bash
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=biz-acme" \
\--data-urlencode "page_size=50"
\```

KYB session payloads carry `session_kind: "business"` and `business_session_id` to distinguish them from KYC sessions.

\## Inspect a single KYB decision

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

KYB decisions include:

\- Company registry data (legal name, registration, status, incorporation date, addresses)
\- `key_people_checks[]` — UBOs, shareholders, directors, officers (registry-sourced and user-submitted, with role tags)
\- `aml_screenings[]` — company AML and per-person AML
\- `document_verifications[]` — uploaded docs with OCR extracts and signed image URLs

See /business-verification/response-schema for the full payload.

\## Fast path — fully verified right now?

\```bash
curl https://verification.didit.me/v3/businesses/biz-acme/ \
-H "x-api-key: $DIDIT_API_KEY"
\# data.features = { KYB: "Approved" }
\```

The Business entity's `features` map holds the latest company verification status under the `KYB` key.

\## Trigger re-KYB

Annual re-KYB or trigger-based re-checks: create a new session against the same `vendor_data`. The new session attaches to the existing Business entity.

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "wf_kyb_annual", "vendor_data": "biz-acme"}'
\```

\## Generate a KYB PDF report

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o kyb-report.pdf
\```

PDF covers registry data, ownership structure, AML hits, document images, per-officer KYC status, questionnaires, phone verification, email verification, and IP analysis when those features are part of the workflow.

\## Resubmit vs new session

\| Scenario | Use |
\|---|---|
\| Registry needs corrected company name | Resubmit — analyst edits data and re-runs registry |
\| Additional document requested | Resubmit — business uploads the missing document |
\| Annual / trigger-based re-KYB | Create a brand new session |

\`kyb_key_people` and `kyb_registry` cannot be resubmitted directly — to re-verify a person, resubmit their child KYC session; the parent Key People feature re-aggregates automatically.

\## Share a session

\```bash
curl -X POST https://verification.didit.me/v3/session/$SESSION_ID/share/ \
-H "x-api-key: $DIDIT_API_KEY"

curl -X POST https://verification.didit.me/v3/session/import-shared/ \
-H "x-api-key: $RECEIVER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"share_token": "..."}'
\```

\## Failure modes

\- `404` — wrong `vendor_data` casing or no KYB sessions yet.
\- Stale signed image URLs — re-fetch the decision.
\- `session_kind: "user"` events in the same list — filter on `session_kind === "business"` for KYB-only handling.

\## Sources of truth

\- /business-verification/response-schema — full KYB decision payload
\- /business-verification/statuses — feature state machine
\- /entities/businesses/data-model — features map computation
\- /core-technology/reusable-kyc/overview — share / import pattern
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

الصق في

تبقى كل جلسة تحقق من الشركات (KYB) أجرتها شركة مرتبطة بكيان الشركة بشكل دائم. يمكنك استرداد السجل الكامل، وفحص بيانات السجل التجاري ونتائج AML لكل جلسة، وبدء إعادة التحقق، وإنشاء تقارير PDF للمراجعات.## عرض جميع جلسات التحقق من الشركات (KYB) لشركةصفِّ قائمة الجلسات حسب `vendor_data`:```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"
```تتضمن الاستجابة كل جلسة تحقق من الشركات (KYB) بغض النظر عن حالتها.## فهم ميزات KYBتُشغّل جلسة KYB هذه الميزات، ولكل ميزة حالتها الخاصة في قرار الجلسة:| الميزة | ما الذي تغطيه |
| - | - |
| `KYB_REGISTRY` | البحث في السجل التجاري للشركة - الوجود والحالة ومطابقة الهوية |
| `AML` | فحص AML على مستوى الشركة (العقوبات والأخبار السلبية وقوائم المراقبة) |
| `KYB_DOCUMENTS` | جمع المستندات والمقارنة المتقاطعة للنصوص عبر OCR |
| `KYB_KEY_PEOPLE` | المسؤولون وUBOs والمستفيدون الحقيقيون - تحديد الهوية وإجراء KYC اختياريًا |تحتفظ الخريطة `features` في كيان الشركة بأحدث حالة تحقق من الشركة فقط:```json theme={null}
"features": {
  "KYB": "Approved"
}
```راجع [حالات ميزات KYB](https://docs.didit.me/ar/business-verification/statuses.md) للاطلاع على المرجع الكامل.## فحص جلسة تحقق واحدة من الشركات (KYB)```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```يتضمن قرار KYB ما يلي:- بيانات السجل التجاري للشركة (الاسم القانوني والتسجيل والحالة وتاريخ التأسيس والعناوين)
- المسؤولون وUBO المستخرجون من السجل
- هيكل الملكية (جدول الملكية ونسب ملكية المستفيدين الحقيقيين)
- نتائج AML للشركة (المطابقات والدرجات)
- فحص AML لكل UBO ولكل مسؤول
- نتائج المستندات مع استخراجات OCR
- رموز أسباب القرارراجع [مخطط استجابة KYB](https://docs.didit.me/ar/business-verification/response-schema.md) للاطلاع على payload الكامل.## تشغيل إعادة التحققتبدأ إعادة KYB السنوية، وعمليات الفحص المعتمدة على المُشغِّلات، وتدفقات المعالجة كلها بجلسة جديدة:```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyb_annual",
    "vendor_data": "biz-acme"
  }'
```تُرتبط الجلسة الجديدة بكيان الشركة الموجود، وتُحدّث الخريطة `features` عند اكتمالها.## إعادة الإرسال مقابل جلسة تحقق جديدة من الشركات (KYB)| السيناريو | الاستخدام |
| - | - |
| يحتاج البحث في السجل إلى تصحيح اسم الشركة | إعادة الإرسال - يعدّل المحلل البيانات ويعيد تشغيل البحث في السجل |
| طلب مستند إضافي من الشركة | إعادة الإرسال - ترفع الشركة المستند الناقص |
| إعادة KYB سنوية أو المعتمدة على المُشغِّلات | إنشاء جلسة جديدة |## تصدير تقرير KYBأنشئ تقرير PDF شاملًا لأي جلسة تحقق من الشركات (KYB):```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o kyb-report.pdf
```يتضمن التقرير بيانات السجل التجاري وهيكل الملكية ومطابقات AML وصور المستندات وحالة KYC للمسؤولين، وصفحة غلاف تعرض سبب القرار.## مشاركة جلسة تحقق من الشركات (KYB)لتدفقات العمل ضمن الاتحادات أو مع الشركاء:- `POST /v3/session/{session_id}/share/` - توليد token قابل للمشاركة.
- `POST /v3/session/import-shared/` - الاستيراد على الطرف المستقبِل.## المراقبة المستمرةتتلقى كيانات الشركات في وضع المراقبة المستمرة عمليات إعادة فحص AML دورية. عند اكتشاف تطابق جديد مع العقوبات أو الأخبار السلبية، يتم تحديث فحص AML للشركة؛ اقرأه من `aml_screenings[]` في قرار الجلسة.اضبط المراقبة المستمرة في وحدة التحكم عند *سير العمل → \[سير عمل KYB] → AML → المراقبة المستمرة*.## الخطوات التالية> [card] [نظرة عامة على KYB](https://docs.didit.me/ar/business-verification/overview.md)
>
> كيف تعمل جلسات التحقق من الشركات (KYB) من البداية إلى النهاية.> [card] [استجابة KYB](https://docs.didit.me/ar/business-verification/response-schema.md)
>
> مرجع كامل لـpayload القرار.> [card] [الأشخاص الرئيسيون](https://docs.didit.me/ar/entities/businesses/key-people.md)
>
> المسؤولون وUBO والمستخدمون المرتبطون.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.