Advanced Company Search🏫
Overview
Advanced company search with a global scope enables users to explore and identify businesses across the globe using sophisticated search functionalities. These tools typically provide a comprehensive database of companies from various countries and industries.
Overall, our advanced search platforms empower users to efficiently discover and analyze companies on a global scale, facilitating business activities.
Important!
Before you proceed, ensure you review the prerequisites for integrating to our APIs for a more detailed guide.
API Endpoint
<<v3.id.domain>>
Headers
Our service accepts headers for authentication. See below the headers to pass to the API
Header
Type | Description | |
---|---|---|
userId | String | This is your user id retrieved from the portal. Check the getting started article to understand how to retrieve your userId |
apiKey | String | This is your apikey retrieved from the portal. Check the getting started article to understand how to retrieve your apiKey |
Request
Request Parameter | Status | Description | Test Data |
---|---|---|---|
verificationType | Required | This field is used to identify the service being called. Ensure to use the value provided exactly as provided | BUSINESS-VERIFICATION |
countryCode | Required | The countryCode is passed in this field | NG |
rcNumber | Required | The rcNumber is passed in this field | RC111111 |
isConsent | Required | The customer must consent to the verification data policy | true |
{
"verificationType": "BUSINESS-VERIFICATION",
"countryCode": "NG",
"rcNumber": "RC111111",
"isConsent": true
}
Response
Response Parameter | Type | Description |
---|---|---|
responseCode |
String |
Please reference Response Codes page for details on all possible responses |
description |
String |
This is a description of the response received. |
verificationType |
String |
The same verificationType passed in request will be returned here |
verificationStatus |
String |
This field lets you know if the identity verification was successful. Options are: ** VERIFIED:** This means that the rcNumber is valid. |
transactionStatus |
String |
This indicates the wallet debit status. The options are successful or failed. |
transactionReference |
String |
If you supplied a transactionReference, the same will be returned here. Else, we would generate a reference and return that to you in this field. |
transactionDate |
String |
Date the transaction was done |
response |
Json |
This is a Json containing all the actual Company data tied to that rcNumber as retrieved from the service provider. |
{
"responseCode": "00",
"description": "Successful",
"verificationType": "BUSINESS-VERIFICATION",
"verificationStatus": "VERIFIED",
"transactionStatus": "SUCCESSFUL",
"transactionReference": "1630321373727-SPZHVT9A-1708080397389-ae831930-3f65-459a-ba9b-0ff9de966d09",
"transactionDate": "1708080399409",
"searchParameter": null,
"callBackUrl": null,
"livenessScore": 0.0,
"paymentRef": null,
"response": {
"parentId": null,
"searchBusinessName": null,
"name": "YJ.COM, INC.",
"formerName": null,
"registrationNumber": "RC111111",
"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",
"address": "1ST FLOOR,SUM HOUSE,Fake Street",
"state": "California",
"lga": "",
"city": "Los Angeles",
"branchAddress": "1ST FLOOR,SUM HOUSE,Fake Street, Los Angeles,California ",
"headOfficeAddress": null,
"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": [
{
"name": "Eboikpomwen Eki ",
"contacts": {
"email": [
"[email protected]"
],
"phone": [
"08034926354"
]
}
}
],
"country": "United States Of America (USA)",
"countryCode": "US-CA",
"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": "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": "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": []
}
],
"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": "RC111111",
"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",
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "62c2a4868d3193700828014e"
}
},
"faceMatch": null,
"licenseSessionId": null,
"remainingLicenseSessionRound": null
}
Updated 6 days ago