Consejo de Estado

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

Both endpoints below run as 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}.

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

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.

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.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Countries

Search providencias

One providencia

Full reference

​Search providencias

​One providencia

Full reference

Search providencias

One providencia