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

> Consulte os antecedentes na Procuraduría de uma pessoa ou entidade (registros disciplinares, penais, contratuais, fiscais e de perda de investidura) por documento.

Resolve a "Consulta de antecedentes" da Procuraduría General de la
Nación: os registros disciplinares, penais, contratuais, fiscais e de perda de investidura
contidos no sistema SIRI (Sistema de Información de Registro de Sanciones
e Inhabilidades). Dado um tipo e número de documento, retorna o nome
registrado e se a pessoa ou entidade possui registros.

## Solicitação

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

| Campo             | Tipo   | Notas                                                                         |
| ----------------- | ------ | ----------------------------------------------------------------------------- |
| `document_type`   | string | Opcional. Um de `CC`, `CE`, `NIT`, `PEP`, `PPT`. O padrão é `CC`.             |
| `document_number` | string | **Obrigatório.** Número do documento (entre 3 e 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 estes tipos de identidade: `CC` (cédula de
ciudadanía), `CE` (cédula de extranjería), `NIT`, `PEP` (Permiso Especial de
Permanencia) e `PPT` (Permiso por Protección Temporal).

## Resposta

| Campo                                  | Notas                                                                                     |
| -------------------------------------- | ----------------------------------------------------------------------------------------- |
| `found`                                | `true` quando o documento está registrado no SIRI; `false` deixa os demais campos vazios. |
| `document_type`, `document_type_label` | O tipo consultado e seu rótulo em espanhol.                                               |
| `document_number`                      | O documento consultado.                                                                   |
| `full_name`                            | Nome registrado, ou `null` quando não é encontrado.                                       |
| `has_records`                          | `false` para "El ciudadano no presenta antecedentes"; `true` caso contrário.              |
| `status`                               | Frase textual do veredicto (ou o aviso de não registrado) da fonte.                       |
| `message`                              | Mensagem de resultado completa em texto simples, para auditoria ou exibição.              |
| `checked_at`                           | Data e hora da consulta segundo a fonte (hora local da Colômbia), ou `null`.              |

Um registro limpo retorna `has_records: false`. Quando `found` é `false`, o
documento não está registrado no SIRI: `status` contém o aviso correspondente e
os demais campos ficam vazios.

<Note>
  `has_records` reflete o veredicto principal. A lista detalhada de sanções
  para um documento com registros está no certificado oficial, não nesta resposta.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>