# 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.

{% hint style="danger" %}
**Importante**: Para consulta de historial crediticio de personas en Colombia, es necesario comunicarse con el [equipo comercial](https://zapsign.co/es/hablar-con-ventas) para activar esta funcionalidad.
{% endhint %}

<mark style="color:blue;">**`POST`**</mark> `https://api.zapsign.com.br/api/v1/checks/`&#x20;

#### Header

<table><thead><tr><th width="175">Nombre</th><th width="103">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</td></tr></tbody></table>

#### Request Body

<table><thead><tr><th width="155">Nombre</th><th width="131">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>country<mark style="color:red;">*</mark></td><td>string</td><td>BR | CO | CL | MX | PE. Más detalle de consultas disponibles <a href="../background_check/results">haz clic aqui</a></td></tr><tr><td>type<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>"person"</strong>,<strong>"credit_person_co", "credit_person_br",</strong> </p><p>Más detalle de consultas disponibles <a href="../background_check/results">haz clic aqui</a></p></td></tr><tr><td>user_authorized<mark style="color:red;">*</mark></td><td>boolean</td><td>Indica si la persona autorizó la validación. Debe ser <code>true</code> para proceder.</td></tr><tr><td>force_creation</td><td>boolean</td><td>Si <code>true</code> fuerza la creación de una nueva búsqueda de antecedentes si ya existe un resultado. Si <code>false</code>, devuelve el resultado de la consulta de antecedentes creada anteriormente.</td></tr><tr><td>first_name</td><td>string</td><td>Nombre de la persona. Si se especifica, se hace una consulta a bases de datos internacionales para obtener más detalle en los resultados. </td></tr><tr><td>last_name</td><td>string</td><td>Apellido de la persona. Si se especifica, se hace una consulta a bases de datos internacionales para obtener más detalle en los resultados. </td></tr><tr><td>national_id</td><td>string</td><td>Documento de identidad oficial. Se debe enviar national_id, foreign_id, ptp o ppt.</td></tr><tr><td>foreign_id</td><td>string</td><td><p>Documento de identidad de extranjeria. Se debe enviar national_id, foreign_id, ptp o ppt.</p><p>Disponible para CO, CL, MX, PE.</p></td></tr><tr><td>ptp</td><td>string</td><td>Disponible para PE. Permiso de Protección Temporal.
</td></tr><tr><td>ppt</td><td>string</td><td>Disponible para CO. Permiso de Protección Temporal.</td></tr><tr><td>state_id</td><td>string</td><td>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.</td></tr><tr><td>date_of_birth</td><td>string</td><td>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. 
</td></tr><tr><td>region</td><td>string</td><td><p>Obligatorio para BR. Región para la búsqueda de antecedentes. Puede ser una región específica o <code>ALL</code> para búsqueda nacional. Búsquedas nacionales pueden tardar hasta 24 horas, mientras que las regionales tardan entre 2 a 20 minutos.</p><p>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</p></td></tr><tr><td>issue_date</td><td>DateTime</td><td>Fecha de emisión del documento en formato <code>YYYY-MM-DD</code>. Aplica para CL (national_id), CO (national_id y foreign_id),</td></tr><tr><td>custom_input</td><td>string</td><td>Identificador externo opcional para referencia. Máximo 128 caracteres.</td></tr><tr><td>verification_code</td><td>string</td><td>Código de verificación para registros criminales en Perú y Chile.</td></tr><tr><td>issue_number</td><td>string</td><td>Número de documento de identidad chileno. Este número se utiliza para obtener información adicional sobre una persona. Sólo para Chile</td></tr><tr><td>observers</td><td>array&#x3C;string></td><td>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.</td></tr></tbody></table>

{% hint style="warning" %}
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](https://app.zapsign.co/conta/configuracoes/plans?tab=credits).&#x20;

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)
{% endhint %}

#### Ejemplo de solicitud

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

#### Response

{% tabs %}
{% tab title="200 Consulta creada con éxito" %}

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

{% endtab %}
{% endtabs %}

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](https://docs.zapsign.com.br/espanol/check-status)