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
| Key | Description |
|---|---|
| app-id | Your App ID |
| x-api-key | Your Secret Key |
Request Body
| Key | Description |
|---|---|
| country_code | Company country code e.g ng. Get country codes here |
| company_name | Company 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
| Response | Description |
|---|---|
| status | Indicates that the request was successful. |
| response_code | Represents the response code. |
| message | Provides a message indicating that the companies were retrieved successfully. |
| data | An array containing the retrieved company information. |
| name | The name of the company. |
| shortName | The short name of the company. |
| brandName | The brand name of the company. |
| internationalNumber | The international number or registration code of the company. |
| countryCode | The country code of the company. |
Updated over 1 year ago