Geschäftsführer-Abfrage API für Südafrika

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

POST

database-validation

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Gibt die aktuellen Geschäftsführer eines südafrikanischen Unternehmens aus dem CIPC-Handelsregister zurück. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten.

Abdeckung

Abdeckung: —
Land: Südafrika
Service-ID: zaf_company_directors
Datenbereich: Behörden
Kategorie: CompanyRegister

Eingaben

Feld	Erforderlich	Beispiel
`company_registration_number`	Ja	`REG-123456`
`vendor_data`	Nein	`user-1234`

Erforderliche Eingaben: company_registration_number
Optionale Eingaben: vendor_data
Einwilligung: Nicht erforderlich
Verfügbarkeit im Workflow: Im Workflow mit Feldzuordnung verfügbar
Abdeckung: —
Preis: $0.75 pro erfolgreiche Abfrage

In einem Workflow ist company_registration_number nicht auf einem Ausweisdokument aufgedruckt, daher erzeugt kein Schritt diesen Wert allein. Erfassen Sie ihn über eine Fragebogen-Antwort, ein Feld aus einer Document-AI-Extraktion oder einen Wert, den Sie beim Erstellen der Sitzung übergeben, und ordnen Sie ihn dem Schritt Datenbankvalidierung zu. Solange er nicht zugeordnet ist, zeigt der Workflow-Editor diesen Dienst als deaktiviert an und nennt die fehlende Eingabe. Fehlt eine Eingabe zur Laufzeit, wird die Prüfung vor jeder Abfrage übersprungen. Sie zahlen dadurch nie für eine Datenbank, die nicht abgefragt werden konnte.

Body-Parameter

string

Standard:"ZAF"

erforderlich

ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: ZAF

string

Standard:"zaf_company_directors"

erforderlich

Array, das diese Service-ID enthält. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: zaf_company_directors

string

Standard:"REG-123456"

erforderlich

Wert company_registration_number, den dieser Datenbankdienst voraussetzt.Beispiel: REG-123456

string

Standard:"user-1234"

Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen dem gleichen Endbenutzer zuzuordnen und Rauschen bei der Duplikatserkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Hinweise zur Validierung

Übermitteln Sie die oben aufgeführten Felder genau so, wie sie vom Benutzer oder aus dem Dokument erfasst wurden.
Didit validiert Pflichtfelder, bevor die Datenbank abgefragt wird. Anfragen, die vor der Abfrage der Quelle abgelehnt werden, werden nicht berechnet.

So rufen Sie es auf

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

Jeder erfolgreiche Aufruf liefert HTTP 200 zurück. Das Feld outcome_code zeigt, was tatsächlich passiert ist. So wird beispielsweise eine echte biometrische Nichtübereinstimmung (BIOMETRIC_NO_MATCH) von einem Selfie unterschieden, das nicht gelesen werden konnte (BIOMETRIC_IMAGE_UNUSABLE). Der angezeigte status ist der Standardstatus der Funktion. Ihre konfigurierten Aktionen für Partial Match / No Match können ihn überschreiben.

MATCH - Das Register hat die Identität bestätigt, und alle geprüften Felder stimmen überein.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

NO_MATCH - Das Register hat für die übermittelten Daten keine Übereinstimmung ergeben.

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für zaf_company_directors dokumentiert derzeit diese normalisierte Struktur:

Variiert je nach Antwort des Registers.

Preise und SLAs

Abfragen der Geschäftsführer in Südafrika werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.

Preis pro Aufruf: $0.75 USD.
Abrechnung: pro erfolgreiche Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
Latenz: typischerweise p95 < 2 s.
Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026

​Abdeckung

​Eingaben

​Body-Parameter

​Eingaberegeln und Hinweise zur Validierung

​So rufen Sie es auf

​Zurückgegebene Daten

​Preise und SLAs

​Weiterlesen

Abdeckung

Eingaben

Body-Parameter

Eingaberegeln und Hinweise zur Validierung

So rufen Sie es auf

Zurückgegebene Daten

Preise und SLAs

Weiterlesen