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
https://api.verified.africa/sfx-verify/v3/id-service/
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. NOT VERIFIED This means that the rcNumber is invalid PENDING This status means that the verification could not be completed. Refer to the responseCode for the specific failure reason |
| 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 10 months ago
What’s Next