> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/operations/validate-cac.md).

# Validate CAC

To validate a company's CAC *(Corporate Affairs Commission)* registration, make a <mark style="color:yellow;">`POST`</mark> request to this endpoint, passing the company's RC (Registration) number as `cac` in the request body.

A successful request returns a `verification` object confirming the match status, along with a `result` object containing the company's registered details; `name`, `address`, `status`, `registration date`, and its listed directors.

This process allows you to confirm a business is genuinely registered with the CAC before onboarding it as a corporate customer.

<mark style="color:yellow;">`POST`</mark>` ``/api/Operations/v1/KYC/ValidateCAC`

**Headers**

| Name                                                | Value                | Description                                 |
| --------------------------------------------------- | -------------------- | ------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json`   | Format of the request payload               |
| Authorization<mark style="color:red;">\*</mark>     | `bearer {token}`     | Access token obtained from Get Access Token |
| request-reference<mark style="color:red;">\*</mark> | `{unique_reference}` | A unique reference identifying this request |

**Body Parameters**

<table><thead><tr><th>Name</th><th>Data Type (Length)</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>cac</code></td><td>string</td><td>true</td><td>The company's CAC/RC registration number to validate</td></tr></tbody></table>

**Body table**

| Field                    | Data Type | Description                                        |
| ------------------------ | --------- | -------------------------------------------------- |
| `status`                 | boolean   | Whether the overall request succeeded              |
| `message`                | string    | Response message                                   |
| `responseCode`           | string    | Response code returned by the verification service |
| `status`                 | string    | Whether the CAC verification succeeded             |
| `reference`              | string    | Reference ID for this verification request         |
| `rc_number`              | string    | The company's RC (Registration) number             |
| `company_name`           | string    | Registered name of the company                     |
| `email_address`          | string    | Registered email address                           |
| `branchAddress`          | string    | Branch address on record                           |
| `city`                   | string    | City where the company is registered               |
| `address`                | string    | Registered business address                        |
| `company_status`         | string    | Current registration status of the company         |
| `lga`                    | string    | Local Government Area of registration              |
| `date_of_registration`   | string    | Date the company was registered with the CAC       |
| `state`                  | string    | State of registration                              |
| `directors`              | array     | List of the company's registered directors         |
| `directors[].name`       | string    | Director's full name                               |
| `directors[]designation` | string    | Director's designation/role in the company         |

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseurl}}/api/Operations/v1/KYC/ValidateCAC' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data '{
  "cac": "092932"
}'
```

</details>

<details>

<summary>Response : <code>200</code></summary>

```
{
  "status": true,
  "message": "string",
  "responseCode": "string",
  "verification": {
    "status": "string",
    "reference": "string"
  },
  "result": {
    "rc_number": "string",
    "company_name": "string",
    "email_address": "string",
    "branchAddress": "string",
    "city": "string",
    "address": "string",
    "company_status": "string",
    "lga": "string",
    "date_of_registration": "string",
    "state": "string",
    "directors": [
      {
        "name": "string",
        "designation": "string"
      }
    ]
  }
}
```

</details>