> ## 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.

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

> Geschäftsführer südafrikanischer Unternehmen per autoritativer Datenbankabfrage über Didit. Ab $0.75 pro Abruf, ohne Verträge oder Mindestabnahme.

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

**issuing\_state** `string` *required* (default: ZAF)

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

Beispiel: `ZAF`

**services** `string` *required* (default: zaf\_company\_directors)

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`

**company\_registration\_number** `string` *required* (default: REG-123456)

Wert `company_registration_number`, den dieser Datenbankdienst voraussetzt.

Beispiel: `REG-123456`

**vendor\_data** `string` (default: 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

```bash cURL theme={null}
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](https://docs.didit.me/de/core-technology/database-validation/database-validation-warnings.md) können ihn überschreiben.

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

```json 200 OK — MATCH theme={null}
{
  "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.

```json 200 OK — NO_MATCH theme={null}
{
  "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

* [Überblick über die Datenbankvalidierung in Südafrika](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [Überblick über die Datenbankvalidierung](https://docs.didit.me/de/core-technology/database-validation/overview.md)
* [Ergebniscodes](https://docs.didit.me/de/core-technology/database-validation/database-validation-outcome-codes.md)


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