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

> Check whether a person is reported as a responsable fiscal in the Contraloría's SIBOR boletín, by document.

Resolves the "Certificado de Antecedentes de Responsabilidad Fiscal" from the
Contraloría General de la República: a check against SIBOR (Sistema de
Información del Boletín de Responsables Fiscales), the registry of people found
fiscally responsible for damage to public funds. Croma returns its verdict as
structured data.

## Request

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

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

```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" }'
```

This lookup is slower than the others (typically tens of seconds) while the
certificate is generated on demand.

## Response

| Field                                  | Notes                                                                                                    |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `found`                                | `true` when a certificate was issued (SIBOR certifies any valid lookup).                                 |
| `document_type`, `document_type_label` | The queried type and its Spanish label.                                                                  |
| `document_number`                      | The queried document.                                                                                    |
| `is_fiscal_responsible`                | `true` when reported as a responsable fiscal; `false` for the clean "NO SE ENCUENTRA REPORTADO" verdict. |
| `verification_code`                    | Código de Verificación (document + `yymmddhhmmss`), to re-verify the official certificate.               |
| `certified_at`                         | Certificate timestamp (ISO, local Colombia time) derived from the verification code.                     |
| `status`                               | Verbatim CERTIFICA sentence from the certificate.                                                        |
| `message`                              | Full plain-text certificate body, for audit/display.                                                     |

The clean result is `is_fiscal_responsible: false`. The Boletín only lists people
declared fiscally responsible, so any document not on it certifies as not
reported. Use `verification_code` to confirm the certificate's authenticity
with the Contraloría.

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