> ## 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, and read any providencia 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`.          |
| `from_date`           | string  | `YYYY-MM-DD`. Start of the date window.      |
| `to_date`             | string  | `YYYY-MM-DD`. End of the date window.        |
| `registration_number` | string  | Radicado.                                    |
| `reporting_judge`     | string  | Reporting magistrate.                        |
| `plaintiff`           | string  | Claimant.                                    |
| `defendant`           | string  | Respondent.                                  |
| `statute`             | string  | Challenged rule.                             |
| `page`                | integer | 1-1000.                                      |
| `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://www.consejodeestado.gov.co/..." }'
```

Returns the full text of the providencia.

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>