Skip to main content

Verify company using CAC number

POST /api/v1/Identity/verification/verify-company-number

Description​

This endpoint is used to verify a company using its Corporate Affairs Commission (CAC) number.

Headers:

  • Accept-Language: optional, allows changing default response message language, type: string

Content-Type:

  • text/plain
  • application/json
  • text/json

ApiKey:

  • No API key required

Request Body:

  • An object of the CacByCompanyNumberRequest schema.

URL: /api/v1/Identity/verification/cac/verify-company-number

Query Parameters:

  • None

params:

  • version: string, required

Response:

  • The response is a "Success" status with a code of 200.

Error Codes:

  • 400: Bad Request
  • 404: Resource not found
  • 500: Internal server error

Example:

bashCopy codePOST /api/v1/Identity/verification/cac/verify-company-number
Request Body:
    {
    "cac_number": "RC123456"
    }

Response:

jsonCopy codeHTTP/1.1 200 OK
    {
    "company_name": "ABC Corporation",
    "date_of_registration": "2000-01-01T12:00:00.000Z",
    "registration_status": "Active"
    }

Headers​

Accept-Language Change default response message language from English(en). Available languages fr,en Content-Type application/json

Accept text/plain

Body raw(json)​

   {
    "company_number": "<string>",
    "country_code": "<string>"
    }