Südafrika Unternehmensregister-Abfrage API

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_registry" \
  -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_registry",
      "service_name": "South Africa - Company Registry 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_registry",
      "service_name": "South Africa - Company Registry 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_registry" \
  -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_registry",
      "service_name": "South Africa - Company Registry 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_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Sucht ein südafrikanisches Unternehmen anhand der Registernummer im Handelsregister der CIPC. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten.

Abdeckung

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

Eingaben

Feld	Pflicht	Beispiel
`company_registration_number`	Ja	`REG-123456`
`company_name`	Nein	`Sample Company LLC`
`vendor_data`	Nein	`user-1234`

Pflichteingaben: company_registration_number
Optionale Eingaben: company_name, vendor_data
Einwilligung: nicht erforderlich
Verfügbarkeit im Workflow: Im Workflow mit Feldzuordnung verfügbar
Abdeckung: —
Preis: $0.75 pro erfolgreicher Abfrage

Im Workflow steht company_registration_number nicht auf einem Ausweisdokument, daher erzeugt kein Schritt diesen Wert allein. Erfassen Sie ihn über eine Antwort im Fragebogen, ein Extraktionsfeld von Document AI 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 deaktiviert an und benennt die fehlende Eingabe. Zur Laufzeit wird die Prüfung bei einer fehlenden Eingabe vor jeder Abfrage übersprungen, sodass Ihnen nie eine Datenbankabfrage berechnet wird, die nicht durchgeführt 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_registry"

erforderlich

Array mit der ID dieses Dienstes. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: zaf_company_registry

string

Standard:"REG-123456"

erforderlich

Wert für company_registration_number, der von diesem Datenbankdienst benötigt wird.Beispiel: REG-123456

string

Wert für company_name, der von diesem Datenbankdienst benötigt wird.Beispiel: Sample Company LLC

string

Standard:"user-1234"

Ihre dauerhafte Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Störungen bei der Duplikaterkennung zu verringern.Beispiel: user-1234

Regeln für Eingaben und Validierungshinweise

Senden Sie die oben aufgeführten Felder genau so, wie sie vom Benutzer oder aus dem Dokument erfasst wurden.
Didit prüft Pflichtfelder, bevor die Datenbank aufgerufen wird. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

Aufruf

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_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

Jeder erfolgreiche Aufruf liefert HTTP 200 zurück. Das Feld outcome_code zeigt an, was tatsächlich passiert ist. So lässt sich zum Beispiel eine echte biometrische Nichtübereinstimmung (BIOMETRIC_NO_MATCH) von einem Selfie unterscheiden, das nicht lesbar war (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_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

NO_MATCH — Das Register hat für die übermittelten Daten keine Übereinstimmung gefunden.

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

Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt von den Angaben des Registers ab. Das generierte Beispiel für zaf_company_registry dokumentiert derzeit diese normalisierte Struktur:

Variiert je nach Antwort des Registers.

Preise & SLAs

Abfragen des südafrikanischen Unternehmensregisters werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.

Preis pro Aufruf: $0.75 USD.
Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, Pflichtfelder fehlen oder die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
Latenz: typischer p95-Wert < 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

​Regeln für Eingaben und Validierungshinweise

​Aufruf

​Zurückgegebene Daten

​Preise & SLAs

​Weiterlesen

Abdeckung

Eingaben

Body-Parameter

Regeln für Eingaben und Validierungshinweise

Aufruf

Zurückgegebene Daten

Preise & SLAs

Weiterlesen