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

# Superfinanciera

> Obtenha o histórico de actuaciones de uma demanda jurisdicional da Superfinanciera da Colômbia.

Obtém o histórico de actuaciones de uma demanda jurisdicional apresentada
perante a Superintendencia Financiera de Colombia, identificada pelo documento
do demandado e pelo número de radicación da demanda.

`POST /co/superfinanciera/complaints/v1`

| Campo             | Tipo   | Notas                                                                     |
| ----------------- | ------ | ------------------------------------------------------------------------- |
| `document_number` | string | **Obrigatório.** 5-20 dígitos.                                            |
| `filing_number`   | string | **Obrigatório.** Exatamente 10 dígitos (o `numeroRadicación` da demanda). |

```bash theme={"dark"}
curl https://api.croma.run/co/superfinanciera/complaints/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "79696131", "filing_number": "2024051440" }'
```

## Resposta

`actions` é o histórico de actuaciones da demanda, uma entrada por etapa
(da mais antiga à mais recente). Se não houver correspondências, retorna um
array vazio.

| Campo         | Notas                                                                        |
| ------------- | ---------------------------------------------------------------------------- |
| `action_date` | Data da actuación (`yyyy-mm-dd`), ou `null`.                                 |
| `record_id`   | Id da actuación, p. ex. `2024051440-001-000`.                                |
| `party`       | Parte ou órgão envolvido (peticionário, dependência judicial ou a entidade). |
| `action`      | A actuación realizada, p. ex. `AUTO ADMISORIO VERBAL SUMARIO`.               |
| `attachments` | Documentos apresentados com a actuación, ou `null`.                          |
| `annexes`     | Anexos da actuación, ou `null`.                                              |

<Note>
  Esta busca pode demorar mais que uma solicitação típica. É um
  [trabalho assíncrono](/pt/async-jobs). Por padrão a solicitação espera de forma síncrona e
  retorna `{ data }`, ou você pode fazer polling / usar um `callback_url`. Se não
  houver correspondências, retorna um array `actions` vazio, não um erro.
</Note>

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