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

> Busca la jurisprudencia administrativa histórica del Consejo de Estado de Colombia y lee cualquier providencia completa.

Jurisprudencia administrativa histórica desde la Relatoría del Consejo de Estado
(la Relatoría tradicional, que cubre a grandes rasgos las providencias anteriores
a diciembre de 2021). Busca primero y luego lee una providencia completa. Para
diciembre de 2021 en adelante, consulta la página de
[SAMAI](/es/guides/colombia/samai).

<Note>
  Ambos endpoints de abajo se ejecutan como [trabajos asíncronos](/es/async-jobs),
  porque esta fuente puede responder con lentitud. Por defecto la solicitud
  espera en línea y devuelve `{ data }`. Si prefieres no mantener la conexión
  abierta, envía `Prefer: wait=N` para limitar la espera en línea, incluye un
  `callback_url` en el cuerpo o haz polling a `GET /jobs/{id}`.
</Note>

## Buscar providencias

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

Acotar por sección y una ventana de fechas mantiene los resultados relevantes.

| Campo                 | Tipo    | Notas                                                         |
| --------------------- | ------- | ------------------------------------------------------------- |
| `section`             | string  | Etiqueta de sala/sección. `""` significa todas las secciones. |
| `type`                | enum    | `AUTO`, `CONCEPTO` o `SENTENCIA`.                             |
| `from_date`           | string  | `YYYY-MM-DD`. Inicio de la ventana de fechas.                 |
| `to_date`             | string  | `YYYY-MM-DD`. Fin de la ventana de fechas.                    |
| `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 defecto `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"
      }'
```

Devuelve `total`, `count` y las filas coincidentes.

| Campo             | Notas                                                          |
| ----------------- | -------------------------------------------------------------- |
| `radicado`        | Número de proceso.                                             |
| `tipo`            | `AUTO`, `CONCEPTO` o `SENTENCIA`.                              |
| `seccion`         | Sala/sección.                                                  |
| `fecha`           | Fecha de la providencia.                                       |
| `ponente`         | Magistrado ponente.                                            |
| `demandante`      | Demandante.                                                    |
| `demandado`       | Demandado.                                                     |
| `norma_demandada` | Norma demandada.                                               |
| `descriptores`    | Temas.                                                         |
| `es_unificacion`  | Si es una sentencia de unificación.                            |
| `es_extension`    | Si extiende jurisprudencia.                                    |
| `url`             | Enlace permanente al contenido. Úsalo en la consulta de abajo. |

## Una providencia

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

| Campo | Tipo   | Notas                                                                      |
| ----- | ------ | -------------------------------------------------------------------------- |
| `url` | string | **Obligatorio.** El enlace permanente (`url`) de un resultado de búsqueda. |

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

Devuelve el texto completo de la providencia.

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>