Zum Hauptinhalt springen
GET
cURL

KYC- und KYB-Unterstützung

Unterstützt sowohl Sitzungen der Benutzerverifizierung (KYC) als auch der Unternehmensverifizierung (KYB). Didit wählt automatisch die passende PDF-Vorlage aus:
  • Sitzung der Benutzerverifizierung (KYC) → Bericht mit den Abschnitten Ausweisverifizierung, Liveness-Erkennung, Gesichtsabgleich, AML und POA.
  • Sitzung der Unternehmensverifizierung (KYB) → Bericht mit den Abschnitten Unternehmensregister, Schlüsselpersonen (UBOs/Organmitglieder), Dokumente, AML, Fragebogen, Telefon, E-Mail und IP-Analyse, sofern diese Funktionen Teil des Workflows sind.
Beide nutzen dieselbe PDF-Erstellungspipeline und unterstützen die White-Label-Anpassung (Logo, URL der Datenschutzerklärung).

Dateinamenskonvention

Zurückgegeben über den Header Content-Disposition: attachment; filename=....

Statusanforderung

Um ein PDF zu erzeugen, muss die Sitzung den Status APPROVED, DECLINED oder IN_REVIEW haben. Laufende oder noch nicht gestartete Sitzungen geben 403 zurück.

Beispiele

White-Label

Wenn für die Anwendung die White-Label-Anpassung aktiviert ist, verwendet das PDF Ihr Logo und Ihre URL zur Datenschutzerklärung. Konfigurieren Sie dies unter Console → Customization.

Berechtigung

Erforderlich ist read:sessions. Für beide Arten gilt derselbe Scope.

Verwandte Seiten

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

sessionId
string<uuid>
erforderlich

UUID der zu rendernden Sitzung der Benutzerverifizierung (KYC) oder Unternehmensverifizierung (KYB) — die von POST /v3/session/ zurückgegebene session_id. Derselbe Pfad funktioniert für beide Sitzungsarten; verwenden Sie den Dateinamen im Content-Disposition-Header der Antwort, um festzustellen, welchen Berichtstyp Sie erhalten haben.

Muss eine wohlgeformte UUID in Kleinbuchstaben sein. Die Route stimmt nur mit gültigen UUIDs überein, sodass ein fehlerhafter Wert vom URL-Router abgelehnt wird, bevor jeglicher Anwendungscode ausgeführt wird, und die Antwort eine 404-HTML-Seite anstelle der unten gezeigten JSON-Envelope {"detail": ...} ist. Der UUID-Konverter der Route stimmt nur mit der kanonischen Kleinschreibung überein — UUIDs mit Hexadezimal-Großbuchstaben werden mit dem HTML-404-Fehler abgelehnt.

Beispiel:

"11111111-2222-3333-4444-555555555555"

Antwort

Das gerenderte PDF-Dokument, direkt als binäres application/pdf zurückgegeben — es gibt keinen JSON-Wrapper und keine Download-URL-Umleitung. Der Body beginnt mit den Magic Bytes %PDF (PDF 1.7). Speichern Sie es in einer .pdf-Datei oder leiten Sie es per Stream an Ihren Aufrufer weiter.

The response is of type file.

Zuletzt geändert am 7. November 2026