Consulta de empresa

Este endpoint es para crear una consulta de empresa o historia crediticia de empresa.

Importante: Para consulta de historial crediticio de empresa en Colombia, es necesario comunicarse con el equipo comercial para activar esta funcionalidad.

POST https://api.zapsign.com.br/api/v1/checks/

Header

Nombre	Tipo	Descripción
Authorization*	string	API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23

Reqeust Body

Nombre	Tipo	Descripción
country*	string	BR | CO | MX . Más detalle de consultas disponibles haz clic aqui
type*	string	"company", "credit_company_co", "credit_company_br". Más detalle de consultas disponibles haz clic aqui
user_authorized*	boolean	Indica si la empresa autorizó la validación. Debe ser true para proceder.
force_creation	boolean	Si true fuerza la creación de una nueva búsqueda de antecedentes si ya existe un resultado. Si false, devuelve el resultado de la consulta de antecedentes creada anteriormente.
tax_id	string	Documento de identidad oficial.
company_name	string	Nombre de la empresa. Si se especifica, se hace una consulta a bases de datos internacionales para obtener más detalle en los resultados.
observers	array<string>	Representa a los observadores de la consulta de antecedentes (hasta 20 personas), es decir, direcciones de correo electrónico que serán notificadas cuando la consulta de antecedentes haya finalizado. Es un array de correos electrónicos.

Cada consulta de antecedentes tiene un costo adicional que depende del tipo de consulta. Para recargar tu cuenta ingresa a tu cuenta en la sección Planes y Precios > Créditos.

Consulta empresa en CO, BR, CL y PE: 90 créditos (USD$1.8)

Consulta empresa en MX: 130 créditos (USD$2.6)

Consulta de historia crediticia de empresa en CO y BR: 200 créditos (USD$4)

Ejemplo de solicitud

{
    "user_authorized": true,
    "force_creation": true,
    "type": "company",
    "country": "CO",
    "taxl_id": "11111111"
}

Response

200 Consulta creada con éxito

{
    "check_id": "CHK682a755bb7135140248cc8dd1d290a01",
    "status": "not_started",
    "company_name": "",
    "full_name": "",
    "first_name": "",
    "last_name": "",
    "date_of_birth": null,
    "issue_date": null,
    "national_id": "",
    "foreign_id": "",
    "tax_id": "1111111",
    "country": "CO",
    "native_country": "",
    "check_type": "company",
    "lang": "es",
    "region": "",
    "created_at": "2025-03-28T17:49:43.363416Z",
    "last_update_at": "2025-03-28T17:49:43.363435Z"
}