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

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

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

{
    "user_authorized": true,
    "force_creation": true,
    "type": "person",
    "country": "CO",
    "national_id": "11111111"
}

Response

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

PreviousCrear un consulta (check)NextConsulta de empresa

Last updated 12 days ago

Was this helpful?

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