Corte Constitucional

La Corte Constitucional de Colombia ha proferido cerca de 50.000 providencias desde 1992: sentencias de tutela (T), de constitucionalidad (C), de unificación (SU) y autos (A). Cada una llega aquí con su texto completo, lo que resolvió la Corte, los derechos en juego, el magistrado ponente, el expediente y un enlace a la providencia en el sitio de la Corte. Busca en todas a la vez, por tipo, año, expediente, ponente o fecha, o con texto libre que llega hasta el cuerpo de cada providencia.

La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.

Buscar providencias

POST /co/corte-constitucional/rulings-search/v1 Dataset Una sola búsqueda sobre el texto completo de todas las providencias desde 1992, filtrada por tipo, año, expediente, ponente o fecha.

Campo	Tipo	Notas
`query`	string	Palabras opcionales que se buscan en el número de la providencia, el expediente, los temas, la síntesis, lo resuelto y el texto completo.
`type`	string	Tipo de providencia opcional: `T` (tutela), `C` (constitucionalidad), `SU` (unificación) o `A` (auto). También sirven los nombres en español.
`year`	integer	Año opcional de la providencia (el 2025 de la T-013/25). 0 busca en todos los años. Por defecto `0`.
`registration_number`	string	Expediente opcional, como lo escribe la Corte: `T-10417884`, `D-15234`. No importan mayúsculas ni espacios.
`reporting_judge`	string	Magistrado ponente opcional, por su nombre completo como aparece en `reporting_judges`. No importan mayúsculas ni tildes.
`from_date`	string	Opcional: solo providencias proferidas en esta fecha o después, `yyyy-mm-dd`.
`to_date`	string	Opcional: solo providencias proferidas en esta fecha o antes, `yyyy-mm-dd`.
`page`	integer	Número de página, empieza en 1. Por defecto `1`.
`per_page`	integer	Resultados por página (1-50). Por defecto `20`.

curl https://api.croma.run/co/corte-constitucional/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "mínimo vital", "type": "T" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total (coincidencias en todas las páginas), page, per_page, total_pages, count y results[], de la providencia más reciente a la más antigua. Cada resultado incluye id (el número de la providencia en forma canónica, p. ej. T-013/25), number (como lo imprime la Corte), relatoria_id, type y type_code (T, C, SU o A), year, ruling_date, publication_date, proceeding_type, chamber, registration_number (el expediente), reporting_judges[] y reporting_judge_keys[], subject, summary (la síntesis de la relatoría), decision (lo que resolvió la Corte), rights_invoked[], rights_protected[], lower_instances[], related_relatoria_ids[], updated_at y official_url (la página de la providencia en el sitio de la Corte).

Los resultados de búsqueda no incluyen el texto de la providencia: una sola puede tener cientos de miles de caracteres. query sí busca dentro de él, así que una frase del cuerpo encuentra la providencia; para leer el texto usa el endpoint Corte Constitucional Ruling.

Una providencia, completa

POST /co/corte-constitucional/ruling/v1 Dataset

Campo	Tipo	Notas
`ruling_id`	string	Obligatorio. El número de la providencia en cualquiera de las notaciones de la Corte (`T-013/25`, `SU.502/25`, `A. 006/25`, `T-013-25`), o el `relatoria_id` de un resultado de búsqueda o del `related_relatoria_ids[]` de otra providencia.
`offset`	integer	Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`.
`limit`	integer	Cuántos caracteres del texto devolver. La mayoría de las providencias caben en una sola respuesta; las más largas superan el millón de caracteres. Por defecto `200000`.

curl https://api.croma.run/co/corte-constitucional/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "T-013/25" }'

Devuelve as_of, found, ruling_id y ruling, que trae todo lo que devuelve la búsqueda más content: una ventana sobre el texto completo de la providencia, con text, offset, total_length, has_more y next_offset. Cada resultado incluye id (el número de la providencia en forma canónica, p. ej. T-013/25), number (como lo imprime la Corte), relatoria_id, type y type_code (T, C, SU o A), year, ruling_date, publication_date, proceeding_type, chamber, registration_number (el expediente), reporting_judges[] y reporting_judge_keys[], subject, summary (la síntesis de la relatoría), decision (lo que resolvió la Corte), rights_invoked[], rights_protected[], lower_instances[], related_relatoria_ids[], updated_at y official_url (la página de la providencia en el sitio de la Corte).

Las providencias largas superan el millón de caracteres, así que el texto se lee por rangos: envía offset y limit, y luego pasa el next_offset de la respuesta como offset hasta que has_more sea falso.

Un número que la Corte no ha publicado devuelve found: false con HTTP 200, no un error. La Corte publica una providencia hasta un año después de proferirla, así que una reciente puede dar found: false hoy y aparecer el mes siguiente.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Países

Corte Constitucional

Buscar providencias

Una providencia, completa

Referencia completa

​Buscar providencias

​Una providencia, completa

Referencia completa

Buscar providencias

Una providencia, completa