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

> Check a person or entity's Procuraduría antecedentes (disciplinary, penal, contractual, fiscal, and pérdida de investidura records) by document.

Resolves the "Consulta de antecedentes" from the Procuraduría General de la
Nación: the disciplinary, penal, contractual, fiscal, and pérdida de investidura
records held in the SIRI system (Sistema de Información de Registro de Sanciones
e Inhabilidades). Given a document type and number, it returns the registered
name and whether the person or entity has records.

## Request

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

| Field             | Type   | Notes                                                               |
| ----------------- | ------ | ------------------------------------------------------------------- |
| `document_type`   | string | Optional. One of `CC`, `CE`, `NIT`, `PEP`, `PPT`. Defaults to `CC`. |
| `document_number` | string | **Required.** Document number (3-30 alphanumeric characters).       |

```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` maps to these identity types: `CC` (cédula de
ciudadanía), `CE` (cédula de extranjería), `NIT`, `PEP` (Permiso Especial de
Permanencia), and `PPT` (Permiso por Protección Temporal).

## Response

| Field                                  | Notes                                                                                  |
| -------------------------------------- | -------------------------------------------------------------------------------------- |
| `found`                                | `true` when the document is registered in SIRI; `false` leaves the other fields empty. |
| `document_type`, `document_type_label` | The queried type and its Spanish label.                                                |
| `document_number`                      | The queried document.                                                                  |
| `full_name`                            | Registered name, or `null` when not found.                                             |
| `has_records`                          | `false` for "El ciudadano no presenta antecedentes"; `true` otherwise.                 |
| `status`                               | Verbatim verdict sentence (or the not-registered notice) from the source.              |
| `message`                              | Full plain-text result message, for audit/display.                                     |
| `checked_at`                           | Consultation timestamp from the source (local Colombia time), or `null`.               |

A clean record returns `has_records: false`. When `found` is `false`, the
document is not registered in SIRI: `status` carries its notice and the other
fields are empty.

<Note>
  `has_records` reflects the headline verdict. The itemized list of sanctions
  for a record-bearing document is in the official certificate, not this response.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>