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

# Consejo de Estado

> Busque a jurisprudência administrativa histórica do Consejo de Estado da Colômbia e leia qualquer providencia completa.

Jurisprudência administrativa histórica da Relatoría do Consejo de Estado
(a Relatoría tradicional, que cobre em linhas gerais as providencias anteriores
a dezembro de 2021). Busque primeiro e depois leia uma providencia completa. De
dezembro de 2021 em diante, consulte a página do
[SAMAI](/pt/guides/colombia/samai).

<Note>
  Ambos os endpoints abaixo são executados como [trabalhos assíncronos](/pt/async-jobs),
  porque esta fonte pode responder com lentidão. Por padrão a solicitação
  espera de forma síncrona e retorna `{ data }`. Se você preferir não manter a conexão
  aberta, envie `Prefer: wait=N` para limitar a espera síncrona, inclua um
  `callback_url` no corpo ou faça polling em `GET /jobs/{id}`.
</Note>

## Buscar providencias

`POST /co/consejo-estado/search/v1`

Restringir por seção e uma janela de datas mantém os resultados relevantes.

| Campo                 | Tipo    | Notas                                                 |
| --------------------- | ------- | ----------------------------------------------------- |
| `section`             | string  | Rótulo de sala/seção. `""` significa todas as seções. |
| `type`                | enum    | `AUTO`, `CONCEPTO` ou `SENTENCIA`.                    |
| `from_date`           | string  | `YYYY-MM-DD`. Início da janela de datas.              |
| `to_date`             | string  | `YYYY-MM-DD`. Fim da janela de datas.                 |
| `registration_number` | string  | Radicado.                                             |
| `reporting_judge`     | string  | Magistrado ponente.                                   |
| `plaintiff`           | string  | Demandante.                                           |
| `defendant`           | string  | Demandado.                                            |
| `statute`             | string  | Norma demandada.                                      |
| `page`                | integer | 1-1000.                                               |
| `per_page`            | integer | 1-20. Por padrão `5`.                                 |

```bash theme={"dark"}
curl https://api.croma.run/co/consejo-estado/search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "section": "SECCION TERCERA",
        "type": "SENTENCIA",
        "from_date": "2020-01-01",
        "to_date": "2020-12-31"
      }'
```

Retorna `total`, `count` e as linhas correspondentes.

| Campo             | Notas                                                      |
| ----------------- | ---------------------------------------------------------- |
| `radicado`        | Número do processo.                                        |
| `tipo`            | `AUTO`, `CONCEPTO` ou `SENTENCIA`.                         |
| `seccion`         | Sala/seção.                                                |
| `fecha`           | Data da providencia.                                       |
| `ponente`         | Magistrado ponente.                                        |
| `demandante`      | Demandante.                                                |
| `demandado`       | Demandado.                                                 |
| `norma_demandada` | Norma demandada.                                           |
| `descriptores`    | Temas.                                                     |
| `es_unificacion`  | Se é uma sentença de unificação.                           |
| `es_extension`    | Se estende jurisprudência.                                 |
| `url`             | Link permanente para o conteúdo. Use-o na consulta abaixo. |

## Uma providencia

`POST /co/consejo-estado/providencia/v1`

| Campo | Tipo   | Notas                                                                |
| ----- | ------ | -------------------------------------------------------------------- |
| `url` | string | **Obrigatório.** O link permanente (`url`) de um resultado de busca. |

```bash theme={"dark"}
curl https://api.croma.run/co/consejo-estado/providencia/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.consejodeestado.gov.co/..." }'
```

Retorna o texto completo da providencia.

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