Consulta de persona

Este endpoint es para crear una consulta de persona o historia crediticia de persona. Los parámetros que debes enviar, dependen del país y el tipo de consulta. Además, hay parámetros opcionales que pueden mejorar los resultados consultando más bases de datos y filtrar homónimos en algunos casos.

Importante: Para consulta de historial crediticio de personas 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

Request Body

Nombre	Tipo	Descripción
country*	string	BR | CO | CL | MX | PE. Más detalle de consultas disponibles haz clic aqui
type*	string	"person","credit_person_co", "credit_person_br", Más detalle de consultas disponibles haz clic aqui
user_authorized*	boolean	Indica si la persona 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.
first_name	string	Nombre de la persona. Si se especifica, se hace una consulta a bases de datos internacionales para obtener más detalle en los resultados.
last_name	string	Apellido de la persona. Si se especifica, se hace una consulta a bases de datos internacionales para obtener más detalle en los resultados.
national_id	string	Documento de identidad oficial. Se debe enviar national_id, foreign_id, ptp o ppt.
foreign_id	string	Documento de identidad de extranjeria. Se debe enviar national_id, foreign_id, ptp o ppt. Disponible para CO, CL, MX, PE.
ptp	string	Disponible para PE. Permiso de Protección Temporal.
ppt	string	Disponible para CO. Permiso de Protección Temporal.
state_id	string	RG (Registro Geral) en Brasil. Esta identificación tiene diferentes formatos según el estado que emite el documento. Puede tener números y letras, pero se omiten otros caracteres (- * , . ), Necesario para obtener antecedentes completos en Brasil.
date_of_birth	string	Fecha de nacimiento en formato YYYY-MM-DD. Es un campo obligatoria para consulta de extranjeros (foreign_id) en CL y CO, y documento oficial (national_id) en PE y BR. En otras casos, ayuda a obtener resultados más detallados.
region	string	Obligatorio para BR. Región para la búsqueda de antecedentes. Puede ser una región específica o ALL para búsqueda nacional. Búsquedas nacionales pueden tardar hasta 24 horas, mientras que las regionales tardan entre 2 a 20 minutos. DF | AC | AL | AP | AM | BA | CE | ES | GO | MA | MT | MS | MG | PA | PB | PR | PE | PI | RJ | RN | RS | RO | RR | SC | SP | SE | TO | ALL
issue_date	DateTime	Fecha de emisión del documento en formato YYYY-MM-DD. Aplica para CL (national_id), CO (national_id y foreign_id),
custom_input	string	Identificador externo opcional para referencia. Máximo 128 caracteres.
verification_code	string	Código de verificación para registros criminales en Perú y Chile.
issue_number	string	Número de documento de identidad chileno. Este número se utiliza para obtener información adicional sobre una persona. Sólo para Chile
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 de persona en CO, BR, CL y PE: 90 créditos (USD$1.8)

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

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

Ejemplo de solicitud

{
    "user_authorized": true,
    "force_creation": true,
    "type": "person",
    "country": "CO",
    "national_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": "11111111",
    "foreign_id": "",
    "tax_id": "",
    "country": "CO",
    "native_country": "",
    "check_type": "person",
    "lang": "es",
    "region": "",
    "created_at": "2025-03-28T17:49:43.363416Z",
    "last_update_at": "2025-03-28T17:49:43.363435Z"
}

Recuerda que los resultados de una consulta pueden demorar entre 2 y 20 minutos. Para consultar los resultados se puede:

• Endpoint de Resultados de una consulta