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

> Search the historical administrative case-law of Colombia's Consejo de Estado by text and filters, and read any providencia issued before 2022 in full.

Historical administrative case-law from the Relatoría del Consejo de Estado
(the traditional Relatoría, broadly covering providencias before December 2021).
Search first, then read one providencia in full. For December 2021 onward,
cross-reference the [SAMAI](/guides/colombia/samai) page.

<Note>
  Both endpoints below run as [async jobs](/async-jobs), because this source can
  be slow to respond. By default the request waits inline and returns
  `{ data }`. If you'd rather not hold the connection open, send `Prefer: wait=N`
  to cap the inline wait, include a `callback_url` in the body, or poll
  `GET /jobs/{id}`.
</Note>

## Search providencias

`POST /co/consejo-estado/search/v1` Narrowing by section plus a date window keeps results relevant.

| Field | Type | Notes |
| - | - | - |
| `section` | string | Sala/section label. `""` means all sections. |
| `type` | enum | `AUTO`, `CONCEPTO`, or `SENTENCIA`. |
| `registration_number` | string | Radicado. |
| `reporting_judge` | string | Reporting magistrate. |
| `plaintiff` | string | Claimant. |
| `defendant` | string | Respondent. |
| `statute` | string | Challenged rule. |
| `from_date` | string | `YYYY-MM-DD`. Start of the date window. |
| `to_date` | string | `YYYY-MM-DD`. End of the date window. |
| `page` | integer | 1-1000. Default `1`. |
| `per_page` | integer | 1-20. Default `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"
      }'
```

Returns `total`, `count`, and the matching rows.

| Field | Notes |
| - | - |
| `radicado` | Process number. |
| `tipo` | `AUTO`, `CONCEPTO`, or `SENTENCIA`. |
| `seccion` | Sala/section. |
| `fecha` | Providencia date. |
| `ponente` | Reporting magistrate. |
| `demandante` | Claimant. |
| `demandado` | Respondent. |
| `norma_demandada` | Challenged rule. |
| `descriptores` | Topics. |
| `es_unificacion` | Whether it is a unification ruling. |
| `es_extension` | Whether it extends jurisprudence. |
| `url` | Content permalink. Pass it to the lookup below. |

## One providencia

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

| Field | Type | Notes |
| - | - | - |
| `url` | string | **Required.** The content permalink (`url`) from a search row. |

```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://servicios.consejodeestado.gov.co/WebRelatoria/FileReferenceServlet?corp=ce&ext=html&file=233679"
      }'
```

Returns the full text of the providencia.

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