Búsqueda Global de Empresas

¿Qué es la Búsqueda Global de Empresas?

El endpoint de Búsqueda Global de Empresas te permite buscar entidades empresariales en todo el mundo. Esto puede ser útil para verificar la existencia, el estado de registro y los detalles de las empresas en varios países. Este endpoint ayuda a las empresas a asegurar el cumplimiento y verificar la legitimidad de otras entidades empresariales.

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

• Descripción: Realiza una búsqueda de entidades empresariales globales.

• Encabezados:

  • Authorization: Bearer YOUR_API_KEY

  • Content-Type: application/json

Parámetros de la Solicitud:

Parámetro	Tipo	Requerido	Descripción
business_name	string	Sí	El nombre de la empresa a buscar.
country	string	Sí	El país donde se encuentra la empresa.
registration_number	string	No	El número de registro de la empresa.
address	string	No	La dirección de la empresa.
phone	string	No	El número de teléfono de la empresa.
email	string	No	La dirección de correo electrónico de la empresa.

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

Códigos de Error

La API utiliza códigos de estado HTTP estándar para indicar el éxito o el fracaso de una solicitud API. La siguiente tabla proporciona detalles de los códigos de error comunes:

Código de Estado	Descripción
200	La solicitud fue exitosa.
400	Solicitud incorrecta. Los parámetros de la solicitud son inválidos o faltan.
401	No autorizado. La clave API falta o es inválida.
403	Prohibido. No tienes acceso a este recurso.
404	No encontrado. No se pudo encontrar el recurso solicitado.
500	Error interno del servidor. Ocurrió un error en el servidor.

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));