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.
POST
https://api.zapsign.com.br/api/v1/checks/
Header
Authorization*
string
API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23
Request Body
country*
string
type*
string
"person", "company", "credit_company_co", "credit_person_co", "credit_person_br", "credit_company_br".
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
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: 200 créditos (USD$4)
Ejemplo de solicitud
Response
Recuerda que los resultados de una consulta pueden demorar entre 2 y 20 minutos. Para consultar los resultados se puede:
Last updated
Was this helpful?