> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Policía Nacional

> Consulta los antecedentes judiciales de una persona en Colombia por documento.

Consulta los antecedentes judiciales de una persona en Colombia desde la
Policía Nacional.

`POST /co/policia/criminal-records/v1`

| Campo             | Tipo   | Notas                                                                        |
| ----------------- | ------ | ---------------------------------------------------------------------------- |
| `document_number` | string | **Obligatorio.** Entre 3 y 30 caracteres.                                    |
| `document_type`   | enum   | Tipo de documento colombiano (`CC`, `CE`, `PA`, `DPO`). Por defecto es `CC`. |

```bash theme={"dark"}
curl https://api.croma.run/co/policia/criminal-records/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "1234567890" }'
```

La respuesta indica si la persona tiene asuntos pendientes con las autoridades
judiciales, junto con el veredicto textual de la fuente:

| Campo         | Notas                                                                                              |
| ------------- | -------------------------------------------------------------------------------------------------- |
| `has_records` | `false` para un registro limpio ("NO TIENE ASUNTOS PENDIENTES…"); `true` cuando existen registros. |
| `status`      | Frase de veredicto textual de la fuente.                                                           |
| `full_name`   | Nombre registrado, o `null` cuando la fuente lo omite.                                             |
| `checked_at`  | Marca de tiempo de la consulta según la fuente, o `null` si no está presente.                      |

<Note>
  Esta consulta puede tardar más que una solicitud típica. Es un
  [trabajo asíncrono](/es/async-jobs). Por defecto
  la solicitud espera en línea y devuelve `{ data }`, o puedes hacer polling o usar un
  `callback_url`. Los valores aceptados de `document_type` están enumerados en la referencia de la API.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Tipos de documento aceptados, esquemas y un playground interactivo.
</Card>