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

# Contraloría

> Consulta si una persona está reportada como responsable fiscal en el boletín SIBOR de la Contraloría, por documento.

Resuelve el "Certificado de Antecedentes de Responsabilidad Fiscal" de la
Contraloría General de la República: una verificación contra SIBOR (Sistema de
Información del Boletín de Responsables Fiscales), el registro de personas
declaradas fiscalmente responsables por daño a los recursos públicos. Croma
devuelve su veredicto como datos estructurados.

## Solicitud

`POST /co/contraloria/fiscal-records/v1`

| Campo             | Tipo   | Notas                                                                         |
| ----------------- | ------ | ----------------------------------------------------------------------------- |
| `document_type`   | string | Opcional. Uno de `CC`, `CE`, `TI`, `PA`, `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/contraloria/fiscal-records/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "CC", "document_number": "1234567890" }'
```

Esta consulta es más lenta que las demás (normalmente decenas de segundos)
mientras el certificado se genera bajo demanda.

## Respuesta

| Campo                                  | Notas                                                                                                               |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `found`                                | `true` cuando se emitió un certificado (SIBOR certifica cualquier consulta válida).                                 |
| `document_type`, `document_type_label` | El tipo consultado y su etiqueta en español.                                                                        |
| `document_number`                      | El documento consultado.                                                                                            |
| `is_fiscal_responsible`                | `true` cuando está reportado como responsable fiscal; `false` para el veredicto limpio "NO SE ENCUENTRA REPORTADO". |
| `verification_code`                    | Código de Verificación (documento + `yymmddhhmmss`), para volver a verificar el certificado oficial.                |
| `certified_at`                         | Marca de tiempo del certificado (ISO, hora local de Colombia) derivada del código de verificación.                  |
| `status`                               | Frase CERTIFICA textual del certificado.                                                                            |
| `message`                              | Cuerpo completo del certificado en texto plano, para auditoría o visualización.                                     |

El resultado limpio es `is_fiscal_responsible: false`. El Boletín solo lista
personas declaradas fiscalmente responsables, así que cualquier documento que no
esté en él certifica como no reportado. Usa `verification_code` para confirmar la
autenticidad del certificado con la Contraloría.

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