Consejo de Estado

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.

Ambos endpoints de abajo se ejecutan como trabajos asíncronos, 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}.

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

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.

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.

Referencia completa

Esquemas, campos de respuesta y un playground interactivo.

Primeros pasos

Países

Buscar providencias

Una providencia

Referencia completa

​Buscar providencias

​Una providencia

Referencia completa

Buscar providencias

Una providencia