> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smartcomply.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CAC Avancé

> Récupérez un profil CAC complet incluant les directeurs et la structure de participation.

L'endpoint CAC Avancé renvoie un profil d'entreprise complet depuis la Corporate Affairs Commission, incluant la liste complète des directeurs, leurs détails personnels, les informations de participation et les données PSC affiliées.

## Endpoint

```
POST /api/onboarding/nigeria_kyc/cac_advanced/
```

## Requête

### En-têtes

| En-tête          | Valeur                | Requis |
| ---------------- | --------------------- | ------ |
| `x-access-token` | Votre clé secrète API | Oui    |
| `Content-Type`   | `application/json`    | Oui    |

### Paramètres de corps

| Paramètre             | Type   | Requis | Description                                                                                            |
| --------------------- | ------ | ------ | ------------------------------------------------------------------------------------------------------ |
| `registration_number` | string | Oui    | Le numéro d'enregistrement CAC                                                                         |
| `company_name`        | string | Oui    | Nom de l'entreprise enregistré                                                                         |
| `company_type`        | string | Oui    | Type d'entité : `"RC"` (société enregistrée), `"BN"` (nom commercial) ou `"IT"` (fiduciaire incorporé) |

### Exemple

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/cac_advanced/" \
    -H "x-access-token: YOUR_SECRET_KEY" \
    -H "Content-Type: application/json" \
    -d '{"registration_number": "10056", "company_name": "JOYCE VENTURES", "company_type": "IT"}'
  ```

  ```python Python theme={null}
  import requests
  response = requests.post(
      "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/cac_advanced/",
      headers={"x-access-token": "YOUR_SECRET_KEY", "Content-Type": "application/json"},
      json={"registration_number": "10056", "company_name": "JOYCE VENTURES", "company_type": "IT"},
  )
  ```
</CodeGroup>

## Réponse

### 200 OK

| Champ                                | Type    | Description                                                                     |
| ------------------------------------ | ------- | ------------------------------------------------------------------------------- |
| `data.rc_number`                     | string  | Numéro d'enregistrement                                                         |
| `data.company_name`                  | string  | Nom de l'entreprise                                                             |
| `data.company_id`                    | integer | ID interne de l'entreprise                                                      |
| `data.entity_type`                   | string  | Type d'entité (par ex. `"IT"`, `"RC"`, `"BN"`)                                  |
| `data.company_status`                | string  | Par ex. `"ACTIVE"`                                                              |
| `data.registrationDate`              | string  | Date d'enregistrement                                                           |
| `data.directors`                     | array   | Liste des directeurs avec leurs détails personnels et de participation complets |
| `data.directors[].firstname`         | string  | Prénom du directeur                                                             |
| `data.directors[].surname`           | string  | Nom de famille du directeur                                                     |
| `data.directors[].gender`            | string  | Genre du directeur                                                              |
| `data.directors[].status`            | string  | Statut du directeur (par ex. `"ACTIVE"`)                                        |
| `data.directors[].isChairman`        | boolean | `true` si le directeur est le président                                         |
| `data.directors[].dateOfAppointment` | string  | Date de nomination                                                              |

```json theme={null}
{
  "status": "success",
  "data": {
    "rc_number": "10056",
    "company_name": "JOYCE VENTURES",
    "company_id": 906200,
    "entity_type": "IT",
    "company_status": "ACTIVE",
    "registrationDate": "2007-03-30",
    "directors": [
      {
        "id": 11234246,
        "firstname": "SAMSON",
        "surname": "ADELOLU",
        "otherName": "DANIEL",
        "gender": "MALE",
        "status": "ACTIVE",
        "occupation": "CLERGY",
        "isChairman": true,
        "dateOfAppointment": "2007-03-13T00:00:00.000+00:00",
        "city": "IBADAN",
        "state": "OYO",
        "address": "NO. 4, AGBA ROAD, SANYO"
      }
    ]
  },
  "message": "Business Registration details retrieved successfully"
}
```

### 400 Bad Request

```json theme={null}
{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}
```

### 401 Unauthorized

```json theme={null}
{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}
```


## OpenAPI

````yaml POST /api/onboarding/nigeria_kyc/cac_advanced/
openapi: 3.0.3
info:
  title: Adhere API
  description: >-
    Identity verification, credit checks, transaction monitoring, and loan fraud
    detection across Africa.
  version: 3.0.0
servers:
  - url: https://adhere-api.smartcomply.com
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Nigeria KYC
  - name: Kenya KYC
  - name: Ghana KYC
  - name: Rwanda KYC
  - name: Uganda KYC
  - name: Document Verification
  - name: Biometrics
  - name: Individual Credit
  - name: Business Credit
  - name: Transaction Monitoring
  - name: Transaction Screening
  - name: Transaction KYC
  - name: Loan Fraud
  - name: User Journey
paths:
  /api/onboarding/nigeria_kyc/cac_advanced/:
    post:
      tags:
        - Nigeria KYC
      summary: CAC Advanced
      operationId: cacAdvanced
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - registration_number
                - company_name
                - company_type
              properties:
                registration_number:
                  type: string
                  description: The CAC registration number
                  example: '10056'
                company_name:
                  type: string
                  description: Registered company name
                  example: JOYCE VENTURES
                company_type:
                  type: string
                  description: >-
                    Entity type: RC (registered company), BN (business name), or
                    IT (incorporated trustee)
                  example: IT
      responses:
        '200':
          description: CAC advanced data retrieved
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              data:
                type: array
                items: {}
              message:
                type: string
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              message:
                type: string
                example: Authentication credentials were not provided.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-access-token
      description: Your Adhere API secret key

````