Company Search With Name

This API allows you to search for a company by providing its name and country code. The country code is in strict compliance with the ISO-3166-1 Alpha-2 Standards

👍

TEST DATA

company_name: Doe Venture

country_code: USA

📘

POST

{{URL}}/identitypass/verification/global/company/search

Request Header

KeyDescription
app-idYour App ID
x-api-keyYour Secret Key

Request Body

KeyDescription
country_codeCompany country code e.g ng. Get country codes here
company_nameCompany name

Sample Response

 "id": 33009761,
            "name": "mr timothy adam homer",
            "countryId": 6,
            "occupation": null,
            "nationality": "American",
            "birthYear": 1966,
            "birthMonth": 11,
            "birthDate": null,
            "address": "130, Old Street, EC",
            "countryOfResidence": "America",
            "honorific": "Mr",
            "number": null,
            "isForeign": null,
            "documentType": null,
            "documentIssuedOn": null,
            "documentIssuedBy": null,
            "documentNumber": null,
            "hideAddress": null,
            "email": null,
            "phone": null,
            "countryCode": "USA",
            "companies": [
                {
                    "name": "MAXTER PAY LIMITED",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2017-01-12",
                    "resignedOn": "2017-10-16",
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                },
                {
                    "name": "PAYSTACK LIMITED",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2017-09-12",
                    "resignedOn": null,
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                },
                {
                    "name": "APEX ENGINEERING SOLUTIONS LIMITED",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2016-06-04",
                    "resignedOn": null,
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                },
                {
                    "name": "APEX RECRUITMENT SOLUTIONS LIMITED",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2016-04-06",
                    "resignedOn": null,
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                },
                {
                    "name": "U-PAYE LIMITED",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2017-03-31",
                    "resignedOn": null,
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                },
                {
                    "name": "APEX RESOURCING SOLUTIONS LTD",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2020-09-14",
                    "resignedOn": null,
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                },
                {
                    "name": "1492 LIMITED",
                    "shortName": null,
                    "brandName": null,
                    "countryCode": "USA",
                    "percentage": null,
                    "amount": null,
                    "appointedOn": "2017-01-11",
                    "resignedOn": "2018-05-11",
                    "role": {
                        "id": 58971,
                        "name": "Person with significant control",
                        "providerId": null,
                        "countryId": 6,
                        "translation": {
                            "cs": "Osoba s významnou kontrolou",
                            "de": "Person mit maßgeblicher Kontrolle",
                            "en": "Person with significant control",
                            "es": "Persona con control significativo",
                            "fr": "Personne ayant un contrôle significatif",
                            "lt": "Asmuo, turintis reikšmingą kontrolę",
                            "lv": "Persona ar būtisku kontroli",
                            "nl": "Persoon met aanzienlijke zeggenschap",
                            "pl": "Osoba sprawująca znaczącą kontrolę",
                            "ro": "Persoană cu control semnificativ",
                            "ru": "Лицо, обладающее значительным контролем",
                            "tr": "",
                            "uk": "Особа з істотним контролем",
                            "zh": ""
                        },
                        "isInactive": null,
                        "priority": 1
                    }
                }
            ]
        }]

Response Description

ResponseDescription
statusIndicates that the request was successful.
response_codeRepresents the response code.
messageProvides a message indicating that the companies were retrieved successfully.
dataAn array containing the retrieved company information.
nameThe name of the company.
shortNameThe short name of the company.
brandNameThe brand name of the company.
internationalNumberThe international number or registration code of the company.
countryCodeThe country code of the company.