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

# Procuraduría

> Consulta los antecedentes en la Procuraduría de una persona o entidad (registros disciplinarios, penales, contractuales, fiscales y de pérdida de investidura) por documento.

Resuelve la "Consulta de antecedentes" de la Procuraduría General de la
Nación: los registros disciplinarios, penales, contractuales, fiscales y de pérdida de investidura
contenidos en el sistema SIRI (Sistema de Información de Registro de Sanciones
e Inhabilidades). Dado un tipo y número de documento, devuelve el nombre
registrado y si la persona o entidad tiene registros.

## Solicitud

`POST /co/procuraduria/disciplinary-records/v1`

| Campo             | Tipo   | Notas                                                                         |
| ----------------- | ------ | ----------------------------------------------------------------------------- |
| `document_type`   | string | Opcional. Uno de `CC`, `CE`, `NIT`, `PEP`, `PPT`. Por defecto es `CC`.        |
| `document_number` | string | **Obligatorio.** Número de documento (entre 3 y 30 caracteres alfanuméricos). |

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

`document_type` corresponde a estos tipos de identidad: `CC` (cédula de
ciudadanía), `CE` (cédula de extranjería), `NIT`, `PEP` (Permiso Especial de
Permanencia) y `PPT` (Permiso por Protección Temporal).

## Respuesta

| Campo                                  | Notas                                                                                     |
| -------------------------------------- | ----------------------------------------------------------------------------------------- |
| `found`                                | `true` cuando el documento está registrado en SIRI; `false` deja los demás campos vacíos. |
| `document_type`, `document_type_label` | El tipo consultado y su etiqueta en español.                                              |
| `document_number`                      | El documento consultado.                                                                  |
| `full_name`                            | Nombre registrado, o `null` cuando no se encuentra.                                       |
| `has_records`                          | `false` para "El ciudadano no presenta antecedentes"; `true` en caso contrario.           |
| `status`                               | Frase de veredicto textual (o el aviso de no registrado) de la fuente.                    |
| `message`                              | Mensaje de resultado completo en texto plano, para auditoría o visualización.             |
| `checked_at`                           | Marca de tiempo de la consulta según la fuente (hora local de Colombia), o `null`.        |

Un registro limpio devuelve `has_records: false`. Cuando `found` es `false`, el
documento no está registrado en SIRI: `status` contiene su aviso y los demás
campos quedan vacíos.

<Note>
  `has_records` refleja el veredicto principal. La lista detallada de sanciones
  para un documento con registros está en el certificado oficial, no en esta respuesta.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>