> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/onboarding/kyc/nigeria/company-verification/cac-company.md).

# Empresa CAC

Obtém a **informação detalhada** de uma empresa específica registrada na **CAC** da Nigéria a partir do seu ID.

### Endpoint

```
GET /kyc/nga/cac/company/{id}
```

### Autenticação

| Tipo    | Localização | Nome          |
| ------- | ----------- | ------------- |
| API Key | Cabeçalho   | **x-api-key** |

### Parâmetros de rota

| Parâmetro | Tipo   | Obrigatório | Descrição                          |
| --------- | ------ | ----------- | ---------------------------------- |
| `id`      | string | **Sim**     | **ID da empresa** obtido da busca. |

### Exemplo de solicitação

```
GET /kyc/nga/cac/company/company-id-123
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro              | Tipo    | Descrição                                                                                                                  |
| ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `serviceResultCode`    | integer | Código que indica o **resultado geral** da execução do serviço. Ver [Código de Resultado do Serviço](#service-result-code) |
| `serviceTime`          | string  | Tempo de processamento **(milissegundos)**.                                                                                |
| `serviceResultLog`     | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção no módulo.              |
| `serviceTransactionId` | string  | Identificador de transação associado à solicitação processada pela API.                                                    |
| `data`                 | object  | Objeto com os dados completos da empresa. Ver tabela a seguir.                                                             |

#### Parâmetros de resposta — `data`

| Parâmetro                | Tipo    | Descrição                                                                     |
| ------------------------ | ------- | ----------------------------------------------------------------------------- |
| `id`                     | string  | Identificador único da empresa.                                               |
| `rcNumber`               | string  | Número de registro (RC Number).                                               |
| `companyName`            | string  | Nome registrado da empresa.                                                   |
| `companyType`            | string  | Tipo de empresa.                                                              |
| `status`                 | string  | Estado atual da empresa. Valores possíveis: `ACTIVE`, `INACTIVE`, `DISSOLVED` |
| `registrationDate`       | string  | Data de cadastro.                                                             |
| `address`                | string  | Endereço registrado.                                                          |
| `city`                   | string  | Cidade.                                                                       |
| `state`                  | string  | Status.                                                                       |
| `email`                  | string  | Endereço de e-mail.                                                           |
| `phoneNumber`            | string  | Número de telefone.                                                           |
| `authorizedShareCapital` | string  | **Capital social autorizado**.                                                |
| `paidUpShareCapital`     | string  | **Capital social integralizado**.                                             |
| `businessActivity`       | string  | Principal atividade comercial.                                                |
| `numberOfDirectors`      | integer | Número de diretores.                                                          |
| `numberOfShareholders`   | integer | Número de acionistas.                                                         |

#### Código de Resultado do Serviço

O `serviceResultCode` indica o resultado geral da execução do serviço:

| serviceResultCode | Descrição                                                                              | Código HTTP |
| ----------------- | -------------------------------------------------------------------------------------- | ----------- |
| 200               | A execução do serviço foi bem-sucedida, o módulo processou a solicitação corretamente. | 200         |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 200,
  "serviceTime": "1500",
  "serviceResultLog": "Success",
  "serviceTransactionId": "c29f013g-12g0-9f1j-f64f-0g469fh00hi",
  "data": {
    "id": "company-id-123",
    "rcNumber": "RC123456",
    "companyName": "ACME NIGERIA LIMITED",
    "companyType": "LIMITED LIABILITY COMPANY",
    "status": "ACTIVE",
    "registrationDate": "2020-05-15",
    "address": "123 Business Street, Victoria Island, Lagos",
    "city": "Lagos",
    "state": "Lagos State",
    "email": "info@acme-nigeria.com",
    "phoneNumber": "+234-1-234-5678",
    "authorizedShareCapital": "10000000",
    "paidUpShareCapital": "5000000",
    "businessActivity": "Information Technology Services",
    "numberOfDirectors": 3,
    "numberOfShareholders": 2
  }
}
```

#### `400` Requisição inválida

Error retornado com o envelope do serviço (`serviceResultCode` reflete o código HTTP da resposta):

```json
{
  "serviceResultCode": 400,
  "serviceResultLog": "Sorry, lookup failed. Please check the details and try again",
  "serviceTime": "151",
  "serviceTransactionId": "08ac9699-dc9e-4cdc-81d7-264f71838309"
}
```

#### `502` Gateway inválido

Retornado quando o serviço não está disponível temporariamente ou sua resposta não pôde ser interpretada. O corpo usa o envelope do serviço com `serviceResultCode: 500`:

```json
{
  "serviceResultCode": 500,
  "serviceResultLog": "Service temporarily unavailable. Please try again later",
  "serviceTime": "3000",
  "serviceTransactionId": "38de2932-0f2h-7gff-14g0-597h04161632"
}
```

#### `504` Tempo esgotado no gateway

Erro de **timeout**, retornado com o envelope do serviço:

```json
{
  "serviceResultCode": 504,
  "serviceResultLog": "Request timeout. Please try again",
  "serviceTime": "30000",
  "serviceTransactionId": "48ef3043-1g3i-8hgg-25h1-608i15272743"
}
```

{% hint style="info" %}
Os erros de autenticação (`401`/`403`) são rejeitados pelo **gateway antes de chegar ao serviço** e **não** usam o envelope `serviceResultCode`. Os erros de validação da plataforma usam o formato `application/problem+json`. Consulte [Tratamento de erros](/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/onboarding/kyc/nigeria.md#manejo-de-errores) para ver os detalhes das três formas de resposta.
{% endhint %}