🌍KYB Basic

This service allows you to lookup a Nigerian business and get the available details.

NOTE: For Nigerian businesses, the registration number must contain the appropriate prefix and the corresponding registry number WITHOUT any space or character in between. e.g RC0000000

POST {{baseurl}}/v2/api/verifications/ng/company/basic

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Name	Type	Description
registrationNumber*	String	Registration number of business. Prefix the registration number with RC for Private companies limited by shares, BN for business name, IT for incorporated trustees, LP for limited partnership and LLP for limited liability partnerships. NOTE: For Nigerian businesses, the registration number must contain the appropriate prefix and the corresponding registration number WITHOUT any space or character in between. e.g RC0000000
isConsent*	Boolean	Indicate you have consent. Must be true

KYB Basic Request

{
    "registrationNumber": "RC0000000",
    "isConsent": true
}

Found Response

{
        "success": true,
        "statusCode": 200,
        "message": "success",
        "data": {
            "id": "68d57134c904ee5fcb605833",
            "status": "found",
            "businessId": "61d880f1e8e15aaf24558f1a",
            "parentId": null,
            "isConsent": true,
            "type": "basic_company_check",
            "searchTerm": "RC00000000",
            "name": "John Doe Inc",
            "registrationNumber": "RC00000000",
            "companyStatus": "ACTIVE",
            "requestedAt": "2025-09-25T16:43:33.422Z",
            "country": "Nigeria",
            "createdAt": "2022-11-03T14:16:54.235Z",
            "lastModifiedAt": "2022-11-03T14:16:54.235Z",
            "typeOfEntity": "PRIVATE COMPANY LIMITED BY SHARES",
            "registrationDate": "2017-06-09",
            "natureOfBusiness": "Information service activities",
            "amlReport": null,
            "adverseMediaReport": null,
            "requestedBy": {
                "firstName": "API",
                "lastName": "User",
                "middleName": "",
                "id": "61d880f1e8e15aaf24558f1c"
            }
        },
        "links": []
    }

Not Found Response

HTTP/1.1 200 OK
{
        "success": true,
        "statusCode": 200,
        "message": "success",
        "data": {
            "parentId": null,
            "reason": "Company details not found",
            "name": null,
            "registrationNumber": "00000000",
            "registryNumber": null,
            "vatNumber": null,
            "registrationDate": null,
            "dateDisolved": null,
            "email": null,
            "phone": null,
            "typeOfEntity": null,
            "activity": null,
            "address": null,
            "branchAddress": null,
            "headOfficeAddress": null,
            "status": "not_found",
            "companyStatus": "Unknown",
            "isConsent": true,
            "lastUpdatedAt": null,
            "paidShareCapital": null,
            "subscribedShareCapital": null,
            "sharesValue": null,
            "activityDescription": null,
            "sharesIssued": null,
            "parentCountry": null,
            "businessId": "61d880f1e8e15aaf24558f1a",
            "type": "advance_company_check",
            "requestedAt": "2022-08-28T23:56:37.447Z",
            "requestedById": "61d880f2e8e15aaf24558f9b",
            "countryCode": "BE",
            "searchTerm": "00000000",
            "companyContactPersons": [],
            "keyPersonnel": [],
            "activities": [],
            "legalEntityIdentifierRegister": [],
            "centralIndexKeyRegister": [],
            "filings": [],
            "affiliates": [],
            "createdAt": "2022-08-28T23:56:37.668Z",
            "lastModifiedAt": "2022-08-28T23:56:37.668Z",
            "_createdAt": "2022-08-29T00:56:3737+01:00",
            "_lastModifiedAt": "2022-08-29T00:56:3737+01:00",
            "id": "630c00b3c0f18977d763855e",
            "requestedBy": {
                "firstName": "Famous",
                "lastName": "Ehichioya",
                "middleName": "Prior",
                "id": "61d880f2e8e15aaf24558f9b"
            }
        },
        "links": []
    }

Error Response

HTTP/1.1 404 NotFound
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}