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

# Historique KYB d'entreprise : sessions et rapports

> Récupérez toutes les sessions KYB liées à une entité Didit, consultez les données du registre et les correspondances AML, et générez des rapports de conformité.



Prompt de l'historique KYB
        Copier le prompt dans le presse-papiers



      
      

\<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>



      
      

Coller dans

Chaque session de vérification d'entreprise (KYB) exécutée pour une entité d'entreprise reste définitivement rattachée à cette entité. Vous pouvez récupérer l'historique complet, consulter les données du registre et les correspondances AML de chaque session, déclencher une revérification et générer des rapports PDF pour les audits.## Lister toutes les sessions de vérification d'entreprise (KYB) d'une entrepriseFiltrez la liste des sessions par `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"
```La réponse inclut toutes les sessions de vérification d'entreprise (KYB), quel que soit leur statut.## Comprendre les fonctionnalités KYBUne session KYB exécute ces fonctionnalités, et chacune a son propre statut dans la décision de session :| Fonctionnalité | Périmètre |
| - | - |
| `KYB_REGISTRY` | Consultation du registre des entreprises : existence, statut, recoupement d'identité |
| `AML` | Filtrage AML au niveau de l'entreprise (sanctions, presse négative, listes de surveillance) |
| `KYB_DOCUMENTS` | Collecte de documents et recoupement avec l'OCR |
| `KYB_KEY_PEOPLE` | Dirigeants, UBO, bénéficiaires effectifs : identification et KYC facultatif |La structure `features` de l'entité entreprise ne contient que le dernier statut de vérification de l'entreprise :```json theme={null}
"features": {
  "KYB": "Approved"
}
```Consultez [Statuts des fonctionnalités KYB](https://docs.didit.me/fr/business-verification/statuses.md) pour la référence complète.## Consulter une session de vérification d'entreprise (KYB) unique```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```La décision KYB comprend :- Données du registre de l'entreprise (raison sociale, numéro d'immatriculation, statut, date de constitution, adresses)
- Dirigeants et UBO extraits du registre
- Structure de l'actionnariat (table de capitalisation, pourcentages de propriété effective)
- Résultats AML de l'entreprise (correspondances, scores)
- AML par personne pour chaque UBO et chaque dirigeant
- Résultats des documents avec extraits OCR
- Codes de motif de décisionConsultez [Schéma de réponse KYB](https://docs.didit.me/fr/business-verification/response-schema.md) pour le payload complet.## Déclencher une revérificationLa revérification KYB annuelle, les contrôles basés sur des déclencheurs et les processus de remédiation commencent tous par une nouvelle session :```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"
  }'
```La nouvelle session est rattachée à l'entité entreprise existante et met à jour la structure `features` une fois terminée.## Nouvelle soumission ou nouvelle session de vérification d'entreprise (KYB)| Scénario | Action à effectuer |
| - | - |
| La consultation du registre nécessite une raison sociale corrigée | Soumettre à nouveau : l'analyste modifie les données et relance la consultation du registre |
| Un document supplémentaire est demandé à l'entreprise | Soumettre à nouveau : l'entreprise téléverse le document manquant |
| Re-KYB annuelle ou basée sur un déclencheur | Créer une nouvelle session |## Exporter un rapport KYBGénérez un PDF complet pour n'importe quelle session de vérification d'entreprise (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
```Le PDF comprend les données du registre, la structure de l'actionnariat, les correspondances AML, les images des documents, le statut KYC des dirigeants et une page de garde avec le motif de décision.## Partager une session de vérification d'entreprise (KYB)Pour les workflows de consortium ou de partenaires :- `POST /v3/session/{session_id}/share/` : génère un jeton de partage.
- `POST /v3/session/import-shared/` : importe la session du côté du destinataire.## Surveillance continueLes entités d'entreprise en mode surveillance continue font l'objet de nouveaux contrôles AML périodiques. Lorsqu'une nouvelle correspondance avec une liste de sanctions ou dans la presse négative est détectée, le filtrage AML de l'entreprise est mis à jour. Lisez-le dans `aml_screenings[]` de la décision de session.Configurez la surveillance continue dans la console, à *Workflows → \[KYB workflow] → AML → Ongoing monitoring*.## Étapes suivantes> [card] [Présentation KYB](https://docs.didit.me/fr/business-verification/overview.md)
>
> Fonctionnement de bout en bout des sessions de vérification d'entreprise (KYB).> [card] [Réponse KYB](https://docs.didit.me/fr/business-verification/response-schema.md)
>
> Référence complète du payload de décision.> [card] [Personnes clés](https://docs.didit.me/fr/entities/businesses/key-people.md)
>
> Dirigeants, UBO et utilisateurs liés.


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