# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.youverify.co/know-your-business-services-kyb/kyb-basic.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.