# Business Verification
***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/global/company-advance-check`
#### 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 |
| registrationName | String | Registered name of the business. Provide this to refine the search, especially for older companies. **Only for Nigerian companies**. It will be ignored for other countries. |
| countryCode\* | String | [Get company search supported countries and region](/know-your-business-services-kyb/get-supported-countries-and-regions.md) For any country with sub-divisions, always use the code of the sub-divisions and don't use the main country code. |
| premium | Boolean | Perform premium checks, currently exclusive `NG` *,* `ZA` *and* `KE` |
| isConsent\* | Boolean | Indicate you have consent. `Must be true` |
{% tabs %}
{% tab title="Company Verification (Advanced Search)" %}
```json
{
"registrationNumber": "RC0000000",
"countryCode": "NG",
"isConsent": true
}
```
{% endtab %}
{% tab title="Sample Request SA Premium Company Search" %}
```json
{
"registrationNumber": "201133333323",
"premium": true,
"countryCode": "ZA",
"isConsent": true
}
```
{% endtab %}
{% tab title="Sample Request KE Premium Company Search" %}
```json
{
"registrationNumber": "PVT-JZUA6Z663",
"premium": true,
"countryCode": "KE",
"isConsent": true
}
```
{% endtab %}
{% endtabs %}
{% tabs %}
{% tab title="Found Response" %}
```json
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"parentId": null,
"searchBusinessName": null,
"name": "John Doe Inc",
"formerName": null,
"registrationNumber": "RC00000000",
"registryNumber": "00000000",
"vatNumber": "00000000-0001",
"registrationDate": "2017-06-09T00:00:00.000+00:00",
"registrationSubmissionDate": "2017-05-31T11:22:07.713+00:00",
"dateDisolved": null,
"tin": "00000000-0001",
"jtbTin": null,
"taxOffice": null,
"email": "johnfakedoe@gmail.com",
"phone": "+1 000 000 0000",
"websiteEmail": null,
"typeOfEntity": "PRIVATE COMPANY LIMITED BY SHARES",
"activity": "Information service activities",
"address": "1ST FLOOR,SUM HOUSE,Fake Street",
"state": "LAGOS",
"lga": "Lagos Mainland",
"city": "YABA",
"branchAddress": "1ST FLOOR,SUM HOUSE,Fake Street, YABA, LAGOS STATE ",
"headOfficeAddress": null,
"objectives": "",
"status": "found",
"companyStatus": "ACTIVE",
"isConsent": true,
"lastUpdatedAt": "2022-03-30T14:19:35.571+00:00",
"shareCapitalInWords": "TEN MILLION NAIRA",
"paidShareCapital": "10000000",
"subscribedShareCapital": "10000000",
"sharesValue": "0.01 NGN",
"activityDescription": "Information service activities",
"sharesIssued": "10000000",
"parentCountry": null,
"companyContactPersons": [
{
"contacts": {
"email": [
"jeneki2000@yahoo.co.uk"
],
"phone": [
"08034926354"
]
},
"name": "Eboikpomwen Eki "
}
],
"country": "Nigeria",
"countryCode": "NG",
"keyPersonnel": [
{
"name": "PETER DOE",
"designation": "WITNESS",
"isCorporate": false,
"appointedOn": null,
"resignedOn": null,
"sharesType": "",
"sharesValue": null,
"sharesCount": null,
"occupation": "LAWYER",
"nationality": null,
"birthYear": null,
"birthMonth": null,
"birthDate": null,
"dateOfBirth": null,
"gender": "",
"address": "8C, NONE STREET, ZONE 4",
"countryOfResidence": "NIGERIA",
"number": "",
"isForeign": "false",
"documentType": "",
"documentIssuedOn": null,
"documentIssuedBy": null,
"documentNumber": "",
"email": "",
"phone": "",
"status": "ACTIVE",
"companies": []
},
{
"name": "SUSAN DOE",
"designation": "SECRETARY_COMPANY",
"isCorporate": false,
"appointedOn": null,
"resignedOn": null,
"sharesType": "",
"sharesValue": null,
"sharesCount": null,
"occupation": "SECRETARY",
"nationality": "NIGERIA",
"birthYear": null,
"birthMonth": null,
"birthDate": null,
"dateOfBirth": null,
"gender": "FEMALE",
"address": "11, NONE CRESCENT",
"countryOfResidence": "NIGERIA",
"number": "",
"isForeign": "false",
"documentType": "",
"documentIssuedOn": null,
"documentIssuedBy": null,
"documentNumber": "",
"email": "",
"phone": "",
"status": "ACTIVE",
"companies": []
},
{
"name": "MICHAEL DOE",
"designation": "DIRECTOR",
"isCorporate": null,
"appointedOn": null,
"resignedOn": null,
"sharesType": null,
"sharesValue": null,
"sharesCount": null,
"occupation": "BUSINESS",
"nationality": "NIGERIA",
"birthYear": null,
"birthMonth": null,
"birthDate": null,
"dateOfBirth": null,
"gender": "MALE",
"address": "1, NONE STREET, ",
"countryOfResidence": "NIGERIA",
"number": null,
"isForeign": "false",
"documentType": null,
"documentIssuedOn": null,
"documentIssuedBy": null,
"documentNumber": null,
"email": null,
"phone": null,
"status": "ACTIVE",
"companies": []
},
{
"name": "JANE DOE INC",
"designation": "SHAREHOLDER",
"isCorporate": true,
"appointedOn": "2021-03-17T14:07:43.000+00:00",
"resignedOn": null,
"sharesType": "ORDINARY",
"sharesValue": "9990000",
"sharesCount": "9990000",
"occupation": null,
"nationality": null,
"birthYear": null,
"birthMonth": null,
"birthDate": null,
"dateOfBirth": null,
"gender": null,
"address": "01 COASTAL HIGHWAY,LEWES DE 000000 USA,COUNTY OF SUSSEX",
"countryOfResidence": "UNITED STATES",
"number": null,
"isForeign": "true",
"documentType": null,
"documentIssuedOn": null,
"documentIssuedBy": null,
"documentNumber": null,
"email": null,
"phone": null,
"status": "ACTIVE",
"companies": []
},
{
"name": "JOHN DOE",
"designation": "SHAREHOLDER",
"isCorporate": null,
"appointedOn": null,
"resignedOn": null,
"sharesType": "ORDINARY",
"sharesValue": "10000",
"sharesCount": "10000",
"occupation": null,
"nationality": null,
"birthYear": null,
"birthMonth": null,
"birthDate": null,
"dateOfBirth": null,
"gender": "MALE",
"address": "1 NONE STREET,LEKKI",
"countryOfResidence": "NIGERIA",
"number": null,
"isForeign": "false",
"documentType": null,
"documentIssuedOn": null,
"documentIssuedBy": null,
"documentNumber": null,
"email": null,
"phone": null,
"status": "ACTIVE",
"companies": []
},
{
"name": "JOHN DOE INC",
"designation": "PERSONS WITH SIGNIFICANT CONTROL",
"isCorporate": true,
"appointedOn": "2022-03-30T14:42:16.554+00:00",
"resignedOn": null,
"sharesType": null,
"sharesValue": null,
"sharesCount": null,
"occupation": null,
"nationality": null,
"birthYear": null,
"birthMonth": null,
"birthDate": null,
"dateOfBirth": null,
"gender": null,
"address": "01 COASTAL HIGHWAY,LEWES DE 000000 ",
"countryOfResidence": "UNITED STATES",
"number": null,
"isForeign": "true",
"documentType": null,
"documentIssuedOn": null,
"documentIssuedBy": null,
"documentNumber": null,
"email": null,
"phone": null,
"status": "ACTIVE",
"companies": []
}
],
"activities": [],
"legalEntityIdentifierRegister": [
{
"leiCode": "0000000000000000",
"legalName": "John Doe PLC",
"legalAddressFirstAddressLine": "1 FAKE CRICK AVENUE",
"legalAddressAdditionalAddressLine1": "CAMBRIDGE BIOMEDICAL CAMPUS",
"legalAddressAdditionalAddressLine2": "",
"legalAddressAdditionalAddressLine3": "",
"legalAddressCity": "CAMBRIDGE",
"legalAddressRegion": "GB-CAM",
"legalAddressCountry": "GB",
"legalAddressPostalCode": "CB2 0AA",
"registrationAuthorityID": "R0000000",
"registrationAuthorityEntityID": "00000000",
"legalJurisdiction": "GB",
"entityCategory": "GENERAL",
"registrationInitialRegistrationDate": "2012-06-06",
"registrationLastUpdateDate": "2021-08-21",
"registrationNextRenewalDate": "2022-08-11",
"registrationManagingLOU": "0000000000000000",
"registrationValidationSources": "FULLY_CORROBORATED",
"validationAuthorityID": "RA000000",
"validationAuthorityEntityID": "02700000",
"entityStatus": "ACTIVE",
"status": "ISSUED"
}
],
"centralIndexKeyRegister": [
{
"cik": "000000",
"entityType": "operating",
"sic": "3711",
"sicDescription": "Motor Vehicles & Passenger Car Bodies",
"name": "John Doe, Inc.",
"ein": "000000000000",
"description": "",
"website": "",
"investorWebsite": "",
"tickers": [
"JDL"
],
"stateOfIncorporation": "DE",
"businessAddressStreet1": "3500 FAKE STREET RD",
"mailingAddressCity": "PALO ALTO",
"businessAddressStreet2": null,
"businessAddressCity": "PALO ALTO",
"businessAddressStateOrCountry": "CA",
"businessAddressZipCode": "123454",
"businessAddressStateOrCountryDescription": "CA",
"phone": "000-000-0000",
"_id": "630ac466a4da96dee1fcae97",
"formerNames": [
{
"from": "2005-02-17T00:00:00.000Z",
"to": "2017-01-27T00:00:00.000Z",
"name": "JDL MOTORS INC",
"_id": "630ac466a4da96dee1fcae98"
}
]
}
],
"filings": [
{
"date": "2020-10-31",
"name": "Dissolution",
"type": "Dissolution",
"status": null
},
{
"date": "2017-09-27",
"name": "Incorporation",
"type": "Incorporation",
"status": null
}
],
"affiliates": [
{
"name": "John Doe 1",
"brandName": null,
"shortName": null,
"companyNumber": "0000.000.000",
"countryCode": "NG"
},
{
"name": "John Doe 2",
"brandName": null,
"shortName": null,
"companyNumber": "0000.000.0000",
"countryCode": "NG"
}
],
"businessId": "62c2a4868d319373a6280152",
"type": "advance_company_check",
"requestedAt": "2023-05-12T08:31:33.145Z",
"requestedById": "62c2a4868d3193700828014e",
"searchTerm": "RC00000000",
"createdAt": "2022-11-03T14:16:54.235Z",
"lastModifiedAt": "2022-11-03T14:16:54.235Z",
"_createdAt": "2022-11-03T14:16:5454+00:00",
"_lastModifiedAt": "2022-11-03T14:16:5454+00:00",
"id": "645df96520aa6c7da72458a0",
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "62c2a4868d3193700828014e"
}
},
"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/business-verification.md?ask=
```
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.