> For the complete documentation index, see [llms.txt](https://docs.zapsign.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapsign.com.br/espanol/create-check/create-check-person.md).

# 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="/pages/jjPd2IcUVgpFwJKirqoL">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="/pages/jjPd2IcUVgpFwJKirqoL">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.Este campo también se aplica al PPT (Permiso de Protección Temporal) en Colombia.
</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](/espanol/check-status.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zapsign.com.br/espanol/create-check/create-check-person.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.