Consulta de empresa

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

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	"person", "company", "credit_company_co", "credit_person_co", "credit_person_br", "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.
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.
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.

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: 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"
}