TaxID and Business Verification

This endpoint performs an advance company check and a business tax ID lookup for a Nigerian company, returning a merged result in a single record.

TaxID and Business Verification

POST {{baseurl}}/v2/api/verifications/ng/advance-check-with-tax

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Field	Type	Description
registrationNumber*	String	Company registration number with prefix (e.g., RC1234567, BN12345, IT67890, LP12345, LLP12345)
isConsent*	Boolean	Indicate subject has given consent. Must be true
registeredName	String	Registered name of company, used to refine the search for older companies.
premium	Boolean	Perform premium checks. Defaults to false.
classificationId	String	Business classification ID.
entityId	String	Optional entity ID to link the verification to an existing entity.

TaxID and Business Verification Sample Request

{
    "registrationNumber": "RC00000000",
    "isConsent": true
}

Found Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "businessId": "65114a8ded14f6cf554e6b34",
        "parentId": null,
        "type": "advance_company_check",
        "searchTerm": "RC00000000",
        "searchBusinessName": null,
        "name": "John Doe Inc",
        "formerName": null,
        "brandName": null,
        "registrationNumber": "RC00000000",
        "registryNumber": "00000000",
        "vatNumber": "00000000-0001",
        "premium": false,
        "registrationDate": "2017-06-09T01:00:00.000+01:00",
        "registrationSubmissionDate": "2017-05-31T11:22:07.713+00:00",
        "dateDisolved": null,
        "taxId": "0000000000000",
        "email": "[email protected]",
        "phone": "[phone]",
        "typeOfEntity": "PRIVATE COMPANY LIMITED BY SHARES",
        "natureOfBusiness": null,
        "activity": "Information service activities",
        "address": "1ST FLOOR,SUM HOUSE,Fake Street",
        "branchAddress": "1ST FLOOR,SUM HOUSE,Fake Street, YABA, LAGOS STATE ",
        "headOfficeAddress": null,
        "status": "found",
        "companyStatus": "ACTIVE",
        "companyContactPersons": [
            {
                "name": "Eboikpomwen  Eki ",
                "contacts": {
                    "email": [
                        "[email protected]"
                    ],
                    "phone": [
                        "08034926354"
                    ]
                }
            }
        ],
        "isConsent": true,
        "requestedAt": "2026-03-12T09:57:18.384Z",
        "requestedById": "65114a8eed14f64d2d4e6b35",
        "lastUpdatedAt": "2022-03-30T14:19:35.571+00:00",
        "shareCapitalInWords": "TEN MILLION NAIRA",
        "paidShareCapital": "10000000",
        "subscribedShareCapital": "10000000",
        "sharesValue": "0.01 NGN",
        "imageReport": null,
        "activityDescription": "Information service activities",
        "sharesIssued": "10000000",
        "country": "Nigeria",
        "parentCountry": null,
        "bulkUploadId": null,
        "verificationType": "single",
        "batchSerialNumber": null,
        "amlReport": null,
        "adverseMediaReport": null,
        "countryCode": "NG",
        "keyPersonnel": [
            {
                "name": "PETER DOE",
                "designation": "WITNESS",
                "corporationName": null,
                "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",
                "state": null,
                "lga": null,
                "city": null,
                "streetNumber": null,
                "shareType": null,
                "postcode": null,
                "companyRcNumber": null,
                "companyId": null,
                "countryOfResidence": "NIGERIA",
                "formerNationality": null,
                "shareAllotted": null,
                "accreditationNumber": null,
                "formerSurname": null,
                "formerFirstName": null,
                "formerOtherName": null,
                "otherDirectorshipDetails": null,
                "isChairman": null,
                "firstName": null,
                "uuid": null,
                "otherName": null,
                "surname": null,
                "affiliateType": null,
                "corporateName": null,
                "companyName": null,
                "rcNumber": null,
                "corporateRcNumber": null,
                "number": "",
                "numberOfAffiliates": null,
                "isForeign": "false",
                "documentType": "",
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": "",
                "email": "",
                "phone": "",
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "SUSAN DOE",
                "designation": "SECRETARY_COMPANY",
                "corporationName": null,
                "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",
                "state": null,
                "lga": null,
                "city": null,
                "streetNumber": null,
                "shareType": null,
                "postcode": null,
                "companyRcNumber": null,
                "companyId": null,
                "countryOfResidence": "NIGERIA",
                "formerNationality": null,
                "shareAllotted": null,
                "accreditationNumber": null,
                "formerSurname": null,
                "formerFirstName": null,
                "formerOtherName": null,
                "otherDirectorshipDetails": null,
                "isChairman": null,
                "firstName": null,
                "uuid": null,
                "otherName": null,
                "surname": null,
                "affiliateType": null,
                "corporateName": null,
                "companyName": null,
                "rcNumber": null,
                "corporateRcNumber": null,
                "number": "",
                "numberOfAffiliates": null,
                "isForeign": "false",
                "documentType": "",
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": "",
                "email": "",
                "phone": "",
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "MICHAEL DOE",
                "designation": "DIRECTOR",
                "corporationName": null,
                "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, ",
                "state": null,
                "lga": null,
                "city": null,
                "streetNumber": null,
                "shareType": null,
                "postcode": null,
                "companyRcNumber": null,
                "companyId": null,
                "countryOfResidence": "NIGERIA",
                "formerNationality": null,
                "shareAllotted": null,
                "accreditationNumber": null,
                "formerSurname": null,
                "formerFirstName": null,
                "formerOtherName": null,
                "otherDirectorshipDetails": null,
                "isChairman": null,
                "firstName": null,
                "uuid": null,
                "otherName": null,
                "surname": null,
                "affiliateType": null,
                "corporateName": null,
                "companyName": null,
                "rcNumber": null,
                "corporateRcNumber": null,
                "number": null,
                "numberOfAffiliates": null,
                "isForeign": "false",
                "documentType": null,
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": null,
                "email": null,
                "phone": null,
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "JANE DOE  INC",
                "designation": "SHAREHOLDER",
                "corporationName": null,
                "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",
                "state": null,
                "lga": null,
                "city": null,
                "streetNumber": null,
                "shareType": null,
                "postcode": null,
                "companyRcNumber": null,
                "companyId": null,
                "countryOfResidence": "UNITED STATES",
                "formerNationality": null,
                "shareAllotted": null,
                "accreditationNumber": null,
                "formerSurname": null,
                "formerFirstName": null,
                "formerOtherName": null,
                "otherDirectorshipDetails": null,
                "isChairman": null,
                "firstName": null,
                "uuid": null,
                "otherName": null,
                "surname": null,
                "affiliateType": null,
                "corporateName": null,
                "companyName": null,
                "rcNumber": null,
                "corporateRcNumber": null,
                "number": null,
                "numberOfAffiliates": null,
                "isForeign": "true",
                "documentType": null,
                "documentIssuedOn": null,
                "documentIssuedBy": null,
                "documentNumber": null,
                "email": null,
                "phone": null,
                "status": "ACTIVE",
                "companies": []
            },
            {
                "name": "JOHN DOE",
                "designation": "SHAREHOLDER",
                "corporationName": null,
                "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",
                "state": null,
                "lga": null,
                "city": null,
                "streetNumber": null,
                "shareType": null,
                "postcode": null,
                "companyRcNumber": null,
                "companyId": null,
                "countryOfResidence": "NIGERIA",
                "formerNationality": null,
                "shareAllotted": null,
                "accreditationNumber": null,
                "formerSurname": null,
                "formerFirstName": null,
                "formerOtherName": null,
                "otherDirectorshipDetails": null,
                "isChairman": null,
                "firstName": null,
                "uuid": null,
                "otherName": null,
                "surname": null,
                "affiliateType": null,
                "corporateName": null,
                "companyName": null,
                "rcNumber": null,
                "corporateRcNumber": null,
                "number": null,
                "numberOfAffiliates": 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",
                "corporationName": null,
                "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 ",
                "state": null,
                "lga": null,
                "city": null,
                "streetNumber": null,
                "shareType": null,
                "postcode": null,
                "companyRcNumber": null,
                "companyId": null,
                "countryOfResidence": "UNITED STATES",
                "formerNationality": null,
                "shareAllotted": null,
                "accreditationNumber": null,
                "formerSurname": null,
                "formerFirstName": null,
                "formerOtherName": null,
                "otherDirectorshipDetails": null,
                "isChairman": null,
                "firstName": null,
                "uuid": null,
                "otherName": null,
                "surname": null,
                "affiliateType": null,
                "corporateName": null,
                "companyName": null,
                "rcNumber": null,
                "corporateRcNumber": null,
                "number": null,
                "numberOfAffiliates": 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",
                "formerNames": [
                    {
                        "from": "2005-02-17T00:00:00.000Z",
                        "to": "2017-01-27T00:00:00.000Z",
                        "name": "JDL MOTORS INC",
                        "_id": "630ac466a4da96dee1fcae98",
                        "id": "630ac466a4da96dee1fcae98"
                    }
                ],
                "_id": "630ac466a4da96dee1fcae97",
                "id": "630ac466a4da96dee1fcae97"
            }
        ],
        "filings": [
            {
                "date": "2020-10-31",
                "name": "Dissolution",
                "type": "Dissolution",
                "status": null,
                "typeCode": null,
                "natureOfModification": null,
                "activities": []
            },
            {
                "date": "2017-09-27",
                "name": "Incorporation",
                "type": "Incorporation",
                "status": null,
                "typeCode": null,
                "natureOfModification": null,
                "activities": []
            }
        ],
        "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"
            }
        ],
        "itNumber": null,
        "bankName": null,
        "branchCode": null,
        "branchName": null,
        "accountNumber": null,
        "accountType": null,
        "accountHolder": null,
        "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": "69b28dfda0abed50a12224b8",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "65114a8eed14f64d2d4e6b35"
        },
        "taxIdStatus": "found"
    },
    "links": []
}

Error Response

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