> ## 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-Verlauf für Unternehmen: Sitzungen & Berichte

> Alle KYB-Sitzungen einer Didit-Unternehmensentität abrufen, Registerdaten und AML-Treffer prüfen und Compliance-Berichte erstellen.



KYB-Verlaufsprompt
        Prompt in die Zwischenablage kopieren



      
      

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



      
      

Einfügen in

Jede Sitzung zur Unternehmensverifizierung (KYB), die ein Unternehmen durchgeführt hat, bleibt dauerhaft mit der Unternehmensentität verknüpft. Sie können den vollständigen Verlauf abrufen, die Registerdaten und AML-Treffer jeder Sitzung prüfen, eine erneute Verifizierung auslösen und PDF-Berichte für Audits erstellen.## Auflistung aller Sitzungen zur Unternehmensverifizierung (KYB) eines UnternehmensFiltern Sie die Sitzungsliste nach `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"
```Die Antwort enthält alle Sitzungen zur Unternehmensverifizierung (KYB), unabhängig von ihrem Status.## Funktionen der KYB-Prüfung verstehenEine KYB-Sitzung führt diese Funktionen aus, und jede hat in der Sitzungsentscheidung einen eigenen Status:| Funktion | Was sie abdeckt |
| - | - |
| `KYB_REGISTRY` | Abfrage im Unternehmensregister - Existenz, Status, Abgleich der Identität |
| `AML` | AML-Screening auf Unternehmensebene (Sanktionen, negative Medienberichte, Beobachtungslisten) |
| `KYB_DOCUMENTS` | Erfassung von Dokumenten und Abgleich mit OCR-Daten |
| `KYB_KEY_PEOPLE` | Geschäftsführer, UBOs, wirtschaftlich Berechtigte - Identifizierung und optionales KYC |Die `features`-Map der Unternehmensentität enthält nur den neuesten Verifizierungsstatus des Unternehmens:```json theme={null}
"features": {
  "KYB": "Approved"
}
```Die vollständige Referenz finden Sie unter [Status der KYB-Funktionen](https://docs.didit.me/de/business-verification/statuses.md).## Eine einzelne Sitzung zur Unternehmensverifizierung (KYB) prüfen```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Die KYB-Entscheidung enthält:- Daten aus dem Unternehmensregister (rechtlicher Name, Registrierung, Status, Gründungsdatum, Adressen)
- Geschäftsführer und UBOs aus dem Register
- Eigentümerstruktur (Anteilsstruktur, Prozentsätze des wirtschaftlichen Eigentums)
- AML-Ergebnisse des Unternehmens (Treffer, Scores)
- Personenbezogene AML-Prüfung für jeden UBO und Geschäftsführer
- Dokumentergebnisse mit OCR-Auszügen
- Codes für EntscheidungsgründeDer vollständige Payload finden Sie unter [KYB-Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md).## Erneute Verifizierung auslösenJährliche erneute KYB-Verifizierungen, auslösebasierte Nachprüfungen oder Abhilfeprozesse beginnen alle mit einer neuen Sitzung:```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"
  }'
```Die neue Sitzung wird der bestehenden Unternehmensentität zugeordnet und aktualisiert nach Abschluss die `features`-Map.## Erneutes Einreichen oder neue Unternehmensverifizierung (KYB)-Sitzung| Szenario | Verwendung |
| - | - |
| Die Abfrage im Unternehmensregister benötigt einen korrigierten Firmennamen | Erneut einreichen - Analyst bearbeitet die Daten und führt die Registerabfrage erneut aus |
| Vom Unternehmen wird ein zusätzliches Dokument angefordert | Erneut einreichen - Unternehmen lädt das fehlende Dokument hoch |
| Jährliche oder auslösebasierte erneute KYB-Verifizierung | Neue Sitzung erstellen |## Einen KYB-Bericht exportierenErstellen Sie einen umfassenden PDF-Bericht für jede Unternehmensverifizierung (KYB)-Sitzung:```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
```Das PDF enthält Registerdaten, Eigentümerstruktur, AML-Treffer, Dokumentbilder, KYC-Status der Geschäftsführer und eine Titelseite mit dem Entscheidungsgrund.## Eine Unternehmensverifizierung (KYB)-Sitzung teilenFür Konsortial- oder Partner-Workflows:- `POST /v3/session/{session_id}/share/` - erzeugt ein teilbares Token.
- `POST /v3/session/import-shared/` - importiert die Sitzung auf der empfangenden Seite.## Laufende ÜberwachungUnternehmensentitäten im Modus der laufenden Überwachung werden regelmäßig erneut auf AML geprüft. Wird ein neuer Treffer aufgrund von Sanktionen oder negativen Medienberichten erkannt, wird das AML-Screening des Unternehmens aktualisiert. Sie können es aus `aml_screenings[]` in der Sitzungsentscheidung auslesen.Konfigurieren Sie die laufende Überwachung in der Konsole unter *Workflows → \[KYB-Workflow] → AML → Laufende Überwachung*.## Nächste Schritte> [card] [KYB-Übersicht](https://docs.didit.me/de/business-verification/overview.md)
>
> So funktionieren Sitzungen zur Unternehmensverifizierung (KYB) von Anfang bis Ende.> [card] [KYB-Antwort](https://docs.didit.me/de/business-verification/response-schema.md)
>
> Referenz für den vollständigen Entscheidungspayload.> [card] [Schlüsselpersonen](https://docs.didit.me/de/entities/businesses/key-people.md)
>
> Geschäftsführer, UBOs und verknüpfte Benutzer.


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