Active
CAC Business Validation
Call direct CAC business validation endpoints through the Business Validation API.
Authentication
- Send the tenant API key with `X-API-Key`.
- Send `X-Environment` as `sandbox` or `live` where applicable.
- Your API key must include the `business_validation_cac` product scope.
- Your tenant must have access to the product in the selected environment.
- Wallet and rate-limit checks may apply depending on the endpoint.
Endpoint
txt
GET http://identity.stg.parthiantechnology.com/api/v1/company/validation/company/rc?rcNumber=RC1234567
Available Endpoints
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /api/v1/company/validation/company?rcNumber={rc}&entityType={type} | Get company details by RC number and entity type. |
| GET | /api/v1/company/validation/company-tin?rcNumber={rc}&entityType={type} | Get company TIN details by RC number and entity type. |
| GET | /api/v1/company/validation/line-of-business?rcNumber={rc}&entityType={type} | Get registered line of business. |
| GET | /api/v1/company/validation/company/rc?rcNumber={rc} | Get company details by RC number. |
| GET | /api/v1/company/validation/company/name?rcNumber={rc}&entityName={name} | Validate company name against RC number. |
| GET | /api/v1/company/validation/company/tin?tin={tin} | Get company details by TIN. |
| POST | /api/v1/company/validation/company/tin | Generate or retrieve company TIN details. |
| GET | /api/v1/company/validation/affiliates?vrcNumber={vrc} | Get company affiliate records. |
| GET | /api/v1/company/validation/share-capital?vrcNumber={vrc} | Get share capital information. |
| GET | /api/v1/company/validation/share-distribution?vrcNumber={vrc} | Get share distribution information. |
| GET | /api/v1/company/validation/secure/rc?vrcNumber={vrc} | Get secure company details with VRC number. |
| GET | /api/v1/company/validation/assets?vrcNumber={vrc} | Get company asset records. |
| GET | /api/v1/company/validation/certificate?vrcNumber={vrc} | Download company certificate where available. |
| GET | /api/v1/company/validation/status-report?vrcNumber={vrc} | Download company status report where available. |
TIN Generation Request
json
{
"rcNumber": "RC1234567",
"entityType": "LTD",
"address": "12 Marina Road, Lagos",
"state": "Lagos",
"localGovernmentArea": "Lagos Island",
"phone": "08012345678",
"email": "operations@example.com"
}Company Response
json
{
"statusCode": 200,
"success": true,
"message": "Successfully retrieved company data by RC number.",
"data": {
"rcNumber": "RC1234567",
"companyName": "Acme Financial Services Limited",
"companyType": "LTD",
"registrationStatus": "active",
"registeredAddress": "12 Marina Road, Lagos"
}
}cURL
bash
curl -X GET "http://identity.stg.parthiantechnology.com/api/v1/company/validation/company/rc?rcNumber=RC1234567" \ -H "X-API-Key: sk_test_your_key" \ -H "X-Environment: sandbox"