🌍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

Name

Type

Description

token*

String

API secret token

Request Body

Name Type Description

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 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 to South Africa and Kenya
isConsent*	Boolean	Indicate you have consent. `Must be true`

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 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 to South Africa and Kenya

isConsent*

Boolean

Indicate you have consent. Must be true

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

{
    "registrationNumber": "201133333323",
    "premium": true,
    "countryCode": "ZA",
    "isConsent": true
}

{
    "registrationNumber": "PVT-JZUA6Z663",
    "premium": true,
    "countryCode": "KE",
    "isConsent": true
}

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

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": {}
}

PreviousKnow Your Business Services (KYB)NextSearch for Businesses

Last updated 1 month ago