CAC Basic Verification

Confirm that a registration number exists with the Corporate Affairs Commission and return the company record. Requires a valid Idempotency-Key header for live-mode API keys to prevent duplicate charges.

POST/v1/cac/basic

Authorization

api-key

x-api-key<token>

In: header

Header Parameters

X-Correlation-ID?string

Optional. Trace ID propagated to Prembly for end-to-end log correlation.

Idempotency-Key?string

Required for live-mode keys. Unique key identifying this request attempt.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

rcNumber*string

Company registration number as issued by the CAC. Leading zeros are significant.

companyType?string

Registration classification. BN business name, RC registered company, IT incorporated trustees, LP limited partnership, LLP limited liability partnership.

Default"RC"

Value in

"BN"
"RC"
"IT"
"LP"
"LLP"

companyName?string

Company name. Optional; Prembly uses it to refine the match when supplied.

purpose*string

Why this lookup was made, from a fixed list — required on both tiers so an NDPR enquiry about director data can be answered from the record, not from memory.

Value in

"KYB_ONBOARDING"
"CREDIT_ASSESSMENT"
"PROCUREMENT_DUE_DILIGENCE"
"AML_SCREENING"
"PARTNER_VERIFICATION"

Response Body

`application/json`

curl -X POST "https://example.com/v1/cac/basic" \  -H "Content-Type: application/json" \  -d '{    "rcNumber": "092932",    "purpose": "KYB_ONBOARDING"  }'

{  "success": true,  "statusCode": 200,  "message": "Request processed successfully",  "timestamp": "2025-10-20T16:30:00.000Z",  "path": "/v1/auth/register",  "data": {    "riskAssessment": {      "score": 2,      "riskLabel": "low",      "sensitivityTier": "low",      "ageFactor": 0,      "ageDerived": {}    },    "verificationStatus": "VERIFIED",    "referenceId": {},    "verificationId": {},    "charged": true,    "chargeAmount": 0,    "rcNumber": "string",    "companyType": "RC",    "company": {      "companyId": {},      "rcNumber": "092932",      "companyName": "TEST COMPANY",      "entityType": "company",      "companyStatus": "Active",      "companyAddress": {},      "branchAddress": {},      "state": {},      "city": {},      "lga": {},      "registrationDate": "1986-06-04T00:00:00Z",      "emailAddress": {},      "searchScore": {},      "registrationNumber": "RC7192875",      "registryStatus": "ACTIVE",      "statusDetail": {},      "lineOfBusiness": []    }  }}

Empty