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

> Consulte se uma pessoa está reportada como responsável fiscal no boletín SIBOR da Contraloría, por documento.

Resolve o "Certificado de Antecedentes de Responsabilidad Fiscal" da
Contraloría General de la República: uma verificação contra o SIBOR (Sistema de
Información del Boletín de Responsables Fiscales), o registro de pessoas
declaradas fiscalmente responsáveis por dano aos recursos públicos. A Croma
retorna esse veredicto como dados estruturados.

## Solicitação

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

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

Esta consulta é mais lenta que as demais (normalmente dezenas de segundos)
enquanto o certificado é gerado sob demanda.

## Resposta

| Campo                                  | Notas                                                                                                             |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `found`                                | `true` quando um certificado foi emitido (o SIBOR certifica qualquer consulta válida).                            |
| `document_type`, `document_type_label` | O tipo consultado e seu rótulo em espanhol.                                                                       |
| `document_number`                      | O documento consultado.                                                                                           |
| `is_fiscal_responsible`                | `true` quando está reportado como responsável fiscal; `false` para o veredicto limpo "NO SE ENCUENTRA REPORTADO". |
| `verification_code`                    | Código de Verificación (documento + `yymmddhhmmss`), para verificar novamente o certificado oficial.              |
| `certified_at`                         | Data e hora do certificado (ISO, hora local da Colômbia) derivada do código de verificação.                       |
| `status`                               | Frase CERTIFICA textual do certificado.                                                                           |
| `message`                              | Corpo completo do certificado em texto simples, para auditoria ou exibição.                                       |

O resultado limpo é `is_fiscal_responsible: false`. O Boletín lista apenas
pessoas declaradas fiscalmente responsáveis, então qualquer documento que não
esteja nele certifica como não reportado. Use `verification_code` para confirmar a
autenticidade do certificado com a Contraloría.

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