CAC Advance Verification

Confirm a registration number and return every matching company together with its directors. A registration number is not guaranteed unique, so `companies` may contain more than one entry — check `matchCount` before treating the first entry as the answer. Billed separately from CAC Basic Verification; a subscription to one does not grant the other.

POST/v1/cac/advance

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/advance" \  -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",    "companies": [      {        "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": [],        "directors": [          {            "id": {},            "surname": {},            "firstName": {},            "otherName": {},            "email": {},            "phoneNumber": {},            "gender": {},            "dateOfBirth": {},            "dateOfAppointment": {},            "status": "ACTIVE",            "occupation": {},            "nationality": {},            "address": {},            "city": {},            "state": {},            "lga": {},            "identityNumber": {},            "numSharesAlloted": {},            "typeOfShares": {},            "isChairman": {},            "isDesignated": {},            "isCorporate": {},            "affiliateType": {}          }        ]      }    ],    "matchCount": 1  }}

Empty