🌍
Company Verification

post
{{baseurl}}
/v2/api/verifications/global/company-advance-check
Parameters
Header
token*
String
API secret token
Body
registrationNumber*
String
Registration number of company. Prefix the registration number with RC for Private companies limited by shares, BN for business name, IT for incoporated trustees, LP for limited partnership and LLP for limited liability partnerships.
registrationName
String
Registered name of the company. 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 For any country with sub-divisions, always use the code of the sub-divisions and don't use the main country code.
isConsent*
Boolean
Indicate you have consent. Must be true
Responses
Company Verification (Advanced Search)
{
    "registrationNumber": "RC0000000",
    "countryCode": "NG",
    "isConsent": true
}
Found Response
Not Found Response
Error Response
{
    "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": "[email protected]",
        "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": [
                        "[email protected]"
                    ],
                    "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": []
}
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": []
    }
HTTP/1.1 404 NotFound
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}
Know Your Business Services (KYB)
Search for companies
Last modified 3mo ago