Consejo de Estado

Jurisprudência administrativa histórica da Relatoría do Consejo de Estado (a Relatoría tradicional, que cobre em linhas gerais as providencias anteriores a dezembro de 2021). Busque primeiro e depois leia uma providencia completa. De dezembro de 2021 em diante, consulte a página do SAMAI.

Ambos os endpoints abaixo são executados como trabalhos assíncronos, porque esta fonte pode responder com lentidão. Por padrão a solicitação espera de forma síncrona e retorna { data }. Se você preferir não manter a conexão aberta, envie Prefer: wait=N para limitar a espera síncrona, inclua um callback_url no corpo ou faça polling em GET /jobs/{id}.

Buscar providencias

POST /co/consejo-estado/search/v1 Restringir por seção e uma janela de datas mantém os resultados relevantes.

Campo	Tipo	Notas
`section`	string	Rótulo de sala/seção. `""` significa todas as seções.
`type`	enum	`AUTO`, `CONCEPTO` ou `SENTENCIA`.
`from_date`	string	`YYYY-MM-DD`. Início da janela de datas.
`to_date`	string	`YYYY-MM-DD`. Fim da janela de datas.
`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 padrão `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"
      }'

Retorna total, count e as linhas correspondentes.

Campo	Notas
`radicado`	Número do processo.
`tipo`	`AUTO`, `CONCEPTO` ou `SENTENCIA`.
`seccion`	Sala/seção.
`fecha`	Data da providencia.
`ponente`	Magistrado ponente.
`demandante`	Demandante.
`demandado`	Demandado.
`norma_demandada`	Norma demandada.
`descriptores`	Temas.
`es_unificacion`	Se é uma sentença de unificação.
`es_extension`	Se estende jurisprudência.
`url`	Link permanente para o conteúdo. Use-o na consulta abaixo.

Uma providencia

POST /co/consejo-estado/providencia/v1

Campo	Tipo	Notas
`url`	string	Obrigatório. O link permanente (`url`) de um resultado de busca.

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

Retorna o texto completo da providencia.

Referência completa

Esquemas, campos de resposta e um playground interativo.

Primeiros passos

Países

Buscar providencias

Uma providencia

Referência completa

​Buscar providencias

​Uma providencia

Referência completa

Buscar providencias

Uma providencia