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

# Sudafrica - API di ricerca amministratori aziendali

> Ricerca amministratori aziendali in Sudafrica tramite database ufficiali con Didit. A consumo da $0.75, senza contratti né minimi.

Restituisce i direttori attuali di una società sudafricana dal registro commerciale CIPC. Didit espone questo servizio tramite `POST /v3/database-validation/` per permetterti di verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

## Copertura

* **Copertura:** —
* **Paese:** Sudafrica
* **ID del servizio:** `zaf_company_directors`
* **Dominio dei dati:** Governo
* **Categoria:** CompanyRegister

## Input

| Campo | Obbligatorio | Esempio |
| - | -: | - |
| `company_registration_number` | Sì | `REG-123456` |
| `vendor_data` | No | `user-1234` |

* **Input obbligatori:** `company_registration_number`
* **Input facoltativi:** `vendor_data`
* **Consenso:** non richiesto
* **Disponibilità nel workflow:** disponibile nel workflow con mappatura dei campi
* **Copertura:** —
* **Prezzo:** \$0.75 per query riuscita

In un workflow, `company_registration_number` non è stampato su un documento d'identità, quindi nessun passaggio lo produce da solo. Raccoglilo da una risposta di un Questionario, da un campo estratto da Document AI oppure da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio Validazione su database. Finché non è mappato, l'editor del workflow mostra questo servizio disabilitato e indica l'input mancante. In fase di esecuzione, un input mancante fa sì che il controllo venga saltato prima di qualsiasi query, quindi non ti viene mai addebitata una base dati che non sarebbe stato possibile interrogare.

## Parametri del body

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

Codice paese ISO 3166-1 alpha-3 per questo servizio di database.

Esempio: `ZAF`

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

Array che contiene questo ID del servizio. Vincolare il servizio mantiene la richiesta limitata a questo database specifico.

Esempio: `zaf_company_directors`

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

Valore di `company_registration_number` richiesto da questo servizio di database.

Esempio: `REG-123456`

**vendor\_data** `string` (default: user-1234)

Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dovuto ai duplicati.

Esempio: `user-1234`

## Regole sugli input e note di validazione

* Invia i campi elencati sopra esattamente come sono stati acquisiti dall'utente o dal documento.
* Didit valida i campi obbligatori prima di interrogare il database. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

## Come effettuare la chiamata

```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"
```

Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è effettivamente accaduto, distinguendo ad esempio una reale mancata corrispondenza biometrica (`BIOMETRIC_NO_MATCH`) da un selfie che non è stato possibile leggere (`BIOMETRIC_IMAGE_UNUSABLE`). Lo `status` mostrato è lo stato predefinito della funzionalità; le [azioni configurate per Partial Match / No Match](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) possono sostituirlo.

**`MATCH`**: il registro ha confermato l'identità e tutti i campi verificati corrispondono.

```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`**: il registro non ha restituito alcuna corrispondenza per i dati inviati.

```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"
      }
    }
  ]
}
```

## Dati restituiti

I campi esatti esposti in `source_data` dipendono da ciò che restituisce il registro. L'esempio generato per `zaf_company_directors` documenta attualmente questa struttura normalizzata:

* Varia in base alla risposta del registro.

## Prezzi e SLA

Sudafrica - Ricerca dei direttori di società: le query vengono addebitate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.

* **Prezzo per chiamata:** \$0.75 USD.
* **Fatturazione:** per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano i campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
* **Latenza:** p95 tipico \< 2 s.
* **Disponibilità:** 99.9% per trimestre da parte di Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

## Continua a leggere

* [Panoramica della Validazione su database per il Sudafrica](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [Panoramica della Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md)
* [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md)


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