Global Business Search

What is Global Business Search?

The Global Business Search endpoint allows you to search for business entities across the globe. This can be useful for verifying the existence, registration status, and details of companies in various countries. This endpoint helps businesses ensure compliance and verify the legitimacy of other business entities.

• Endpoint: POST {{baseUrl}}/verification/business-search

• Description: Perform a search for global business entities.

• Headers:

  • Authorization: Bearer YOUR_API_KEY

  • Content-Type: application/json

Request Parameters:

Parameter	Type	Required	Description
business_name	string	Yes	The name of the business to search for.
country	string	Yes	The country where the business is located.
registration_number	string	No	The registration number of the business.
address	string	No	The address of the business.
phone	string	No	The phone number of the business.
email	string	No	The email address of the business.

{
    "business_name": "Yativo Inc.",
    "country": "US",
    "registration_number": "123456789",
    "address": "123 Business St, Business City, State, 12345",
    "phone": "[phone]",
    "email": "[e-mail]"
}

Error Codes

The API uses standard HTTP status codes to indicate the success or failure of an API request. The following table provides details of common error codes:

Status Code	Description
200	Request was successful.
400	Bad request. The request parameters are invalid or missing.
401	Unauthorized. The API key is missing or invalid.
403	Forbidden. You do not have access to this resource.
404	Not found. The requested resource could not be found.
500	Internal server error. An error occurred on the server.

Python

import requests

url = "{{baseUrl}}/verification/business-search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "business_name": "Yativo Inc.",
    "country": "US",
    "registration_number": "123456789",
    "address": "123 Business St, Business City, State, 12345",
    "phone": "[phone]",
    "email": "[e-mail]"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

PHP

<?php

$url = "{{baseUrl}}/verification/business-search";
$headers = [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json"
];
$data = [
    "business_name" => "Yativo Inc.",
    "country" => "US",
    "registration_number" => "123456789",
    "address" => "123 Business St, Business City, State, 12345",
    "phone" => "[phone]",
    "email" => "[e-mail]"
];

$options = [
    "http" => [
        "header" => implode("\r\n", $headers),
        "method" => "POST",
        "content" => json_encode($data),
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
if ($response === FALSE) {
    die('Error');
}

echo $response;
?>

JavaScript

const url = '{{baseUrl}}/verification/business-search';
const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
};
const data = {
    business_name: 'Yativo Inc.',
    country: 'US',
    registration_number: '123456789',
    address: '123 Business St, Business City, State, 12345',
    phone: '[phone]',
    email: '[e-mail]'
};

fetch(url, {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(data)
})
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

Global Business Verification

POSThttps://sandbox.yativo.com/verification/business-search

Body

application/json

international_numberstring

country_codestring

business_namestring

business_mobilestring

first_namestring

middle_namestring

date_of_birthstring

last_namestring

emailstring

mobilestring

streetstring

landmarkstring

lgastring

citystring

statestring

ip_addressstring

Response

200

Successful Response

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://sandbox.yativo.com/verification/business-search', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();