> ## 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 or entity is reported as a responsable fiscal in the Contraloría's SIBOR boletín, the record behind the antecedentes certificate.

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.

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

| Field | Type | Notes |
| - | - | - |
| `document_type` | enum | Optional. One of `CC`, `CE`, `TI`, `PA`, `PEP`, `PPT`. Default `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_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, all response fields, and an interactive playground.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.