> ## 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. # API de consulta de diretores de empresas na África do Sul > Consulte diretores de empresas da África do Sul em base oficial via Didit. Pague por chamada a partir de $0.75, sem contratos nem mínimos. Retorna os diretores atuais de uma empresa sul-africana a partir do registro comercial da CIPC. A Didit disponibiliza este serviço por meio de `POST /v3/database-validation/` para que você possa comparar os dados enviados com a fonte oficial e receber resultados de correspondência normalizados. ## Cobertura * **Cobertura:** — * **País:** África do Sul * **ID do serviço:** `zaf_company_directors` * **Domínio de dados:** Governo * **Categoria:** CompanyRegister ## Entradas | Campo | Obrigatório | Exemplo | | - | -: | - | | `company_registration_number` | Sim | `REG-123456` | | `vendor_data` | Não | `user-1234` | * **Entradas obrigatórias:** `company_registration_number` * **Entradas opcionais:** `vendor_data` * **Consentimento:** Não obrigatório * **Disponibilidade no fluxo:** Disponível no fluxo com mapeamento de campos * **Cobertura:** — * **Preço:** \$0.75 por consulta bem-sucedida Em um fluxo de verificação (workflow), o `company_registration_number` não aparece impresso em um documento de identidade, então nenhuma etapa o gera por conta própria. Colete-o a partir de uma resposta de Questionário, de um campo de extração do Document AI ou de um valor que você envia ao criar a sessão, e mapeie-o na etapa de Validação de banco de dados. Enquanto ele não estiver mapeado, o editor de fluxos mostra este serviço desativado e indica a entrada ausente. Em tempo de execução, uma entrada ausente faz com que a verificação seja ignorada antes de qualquer consulta, então você nunca é cobrado por um banco de dados que não pôde ser consultado. ## Parâmetros do corpo **issuing\_state** `string` *required* (default: ZAF) Código de país ISO 3166-1 alpha-3 para este serviço de banco de dados. Exemplo: `ZAF` **services** `string` *required* (default: zaf\_company\_directors) Array que contém este ID de serviço. Fixar o serviço mantém a requisição restrita exatamente a este banco de dados. Exemplo: `zaf_company_directors` **company\_registration\_number** `string` *required* (default: REG-123456) Valor de `company_registration_number` exigido por este serviço de banco de dados. Exemplo: `REG-123456` **vendor\_data** `string` (default: user-1234) Sua referência estável de usuário para esta pessoa, como o seu ID interno de usuário. A Didit a utiliza para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicados. Exemplo: `user-1234` ## Regras de entrada e notas de validação * Envie os campos listados acima exatamente como foram capturados do usuário ou do documento. * A Didit valida os campos obrigatórios antes de chamar o banco de dados. Requisições rejeitadas antes da consulta à fonte não são cobradas. ## Como chamar ```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" ``` Toda chamada bem-sucedida retorna HTTP `200`. O campo **`outcome_code`** informa o que de fato aconteceu, distinguindo, por exemplo, uma divergência biométrica real (`BIOMETRIC_NO_MATCH`) de uma selfie que não pôde ser lida (`BIOMETRIC_IMAGE_UNUSABLE`). O `status` exibido é o status padrão do recurso; as [ações de Partial Match / No Match](https://docs.didit.me/pt-br/core-technology/database-validation/database-validation-warnings.md) que você configurou podem substituí-lo. **`MATCH`**: o registro confirmou a identidade e todos os campos verificados corresponderam. ```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`**: o registro não retornou nenhuma correspondência para os dados enviados. ```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" } } ] } ``` ## Dados retornados Os campos exatos exibidos em `source_data` dependem do que o registro retorna. O exemplo gerado para `zaf_company_directors` documenta atualmente este formato normalizado: * Varia conforme a resposta do registro. ## Preços e SLAs As consultas de diretores de empresas da África do Sul são cobradas apenas quando a Didit recebe um resultado conclusivo da fonte de validação. * **Preço por chamada:** \$0.75 USD. * **Faturamento:** por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte. * **Latência:** p95 típico \< 2 s. * **Disponibilidade:** 99.9% por trimestre do lado da Didit; a disponibilidade da fonte externa varia conforme o país e o conjunto de dados. ## Continue lendo * [Visão geral da Validação de banco de dados da África do Sul](https://docs.didit.me/api-reference/database-validation/south-africa.md) * [Visão geral da Validação de banco de dados](https://docs.didit.me/pt-br/core-technology/database-validation/overview.md) * [Códigos de resultado](https://docs.didit.me/pt-br/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.