Zum Hauptinhalt springen
GET
curl

Überblick

Gibt eine einzelne Unternehmensentität zurück, die über vendor_data identifiziert wird.

Wann Sie es verwenden

  • Abrufen des aktuellen Verifizierungsstatus eines Unternehmens: Die Zuordnung features zeigt Ihnen auf einen Blick den neuesten Status jeder KYB-Funktion.
  • Detailansichten in Ihrer eigenen Admin-Oberfläche.
  • Risiko-Scoring mithilfe aggregierter Zähler und Funktionsstatus.

Hinweise

  • vendor_data in der URL unterscheidet zwischen Groß- und Kleinschreibung.
  • Gibt 404 zurück, wenn kein Unternehmen mit diesem vendor_data existiert.
  • Die aggregierten Zähler (session_count, approved_count, declined_count, in_review_count) werden in Echtzeit aktualisiert, sobald Sitzungen der Unternehmensverifizierung (KYB) abgeschlossen werden.
  • Registerbasierte Felder (legal_name, registration_number, country_code) spiegeln die neueste genehmigte Sitzung der Unternehmensverifizierung (KYB) wider.

Berechtigungen

Die Rolle muss read:businesses gewähren.

Verwandte Themen

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

vendor_data
string
erforderlich

Ihre eindeutige Kennung für das Unternehmen — ein Freitext-String (KEINE UUID), exakt wie übermittelt abgeglichen.

Antwort

Vollständige Unternehmensdetails einschließlich Metadaten und aggregierten Sitzungsdaten.

Vollständige Unternehmensdetails. Erweitert BusinessListItem um Metadaten und updated_at.

didit_internal_id
string<uuid>

Didits stabile interne UUID für dieses Unternehmen.

vendor_data
string | null

Ihre eindeutige Kennung für dieses Unternehmen (beim Erstellen von Sitzungen übergeben). Dies kann null sein, wenn keine Vendor-Kennung angegeben wurde.

display_name
string | null

Von Ihnen festgelegter benutzerdefinierter Anzeigename

Offizieller juristischer Name aus dem Register oder manueller Eingabe

registration_number
string | null

Unternehmensregister- oder Gründungsnummer

country_code
string | null

Gründungsland (ISO 3166-1 Alpha-2, z. B. GB, US).

effective_name
string | null

Bester verfügbarer Name: display_name, falls gesetzt, andernfalls legal_name

status
enum<string>

Lebenszyklusstatus des Unternehmensdatensatzes (KEIN Sitzungsstatus). ACTIVE ist der Standard, FLAGGED markiert ihn für manuelle Prüfung, BLOCKED verhindert neue Sitzungen für dieses vendor_data.

Verfügbare Optionen:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Gesamtzahl der Verifizierungssitzungen für dieses Unternehmen

approved_count
integer

Anzahl der genehmigten Sitzungen

declined_count
integer

Anzahl der abgelehnten Sitzungen

in_review_count
integer

Anzahl der Sitzungen in Prüfung

features
object

Aggregierter Status pro Funktion über alle KYB-Sitzungen dieses Unternehmens hinweg. Derzeit ist der einzige Schlüssel KYB (der Status der Unternehmensprüfung im Register). Mögliche Werte: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Dieselben Daten wie features, als geordnetes Array von {feature, status}-Objekten.

last_session_at
string<date-time> | null

Zeitstempel der letzten Sitzung

first_session_at
string<date-time> | null

Zeitstempel der ersten Sitzung

last_activity_at
string<date-time> | null

Zeitstempel der letzten Aktivität (Statusänderung, Sitzungsaktualisierung usw.)

tags
object[]

Diesem Unternehmen zugewiesene Tags

created_at
string<date-time>
metadata
object

Benutzerdefiniertes Metadaten-JSON, das Sie diesem Unternehmen angehängt haben. Standardmäßig {}.

updated_at
string<date-time>
Zuletzt geändert am 7. November 2026