# KYB Basic

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

*<mark style="color:orange;">**NOTE**</mark>: 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*

<mark style="color:green;">`POST`</mark> `{{baseurl}}/v2/api/verifications/ng/company/basic`

#### Headers

| Name                                    | Type   | Description      |
| --------------------------------------- | ------ | ---------------- |
| token<mark style="color:red;">\*</mark> | String | API secret token |

#### Request Body

| Name                                                 | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| registrationNumber<mark style="color:red;">\*</mark> | String  | Registration number of business. Prefix the registration number with <mark style="color:red;">`RC`</mark> for Private companies limited by shares, <mark style="color:red;">`BN`</mark> for business name, <mark style="color:red;">`IT`</mark> for incorporated trustees, <mark style="color:red;">`LP`</mark> for limited partnership and <mark style="color:red;">`LLP`</mark> for limited liability partnerships. <mark style="color:orange;">**NOTE**</mark>: 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<mark style="color:red;">\*</mark>          | Boolean | Indicate you have consent. <mark style="color:red;">`Must be true`</mark>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

{% tabs %}
{% tab title="KYB Basic Request" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Found Response" %}

```json
{
        "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": []
    }
```

{% endtab %}

{% tab title="Not Found Response" %}

```json
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": []
    }
```

{% endtab %}

{% tab title="Error Response" %}

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

{% endtab %}
{% endtabs %}