> ## 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.
# Corte Constitucional
> Busca en todas las providencias de la Corte Constitucional de Colombia desde 1992, tutelas, constitucionalidad, unificación y autos, y lee el texto completo de cualquiera.
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](/es/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`. |
```bash theme={"dark"}
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`. |
```bash theme={"dark"}
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.
Esquemas, todos los campos de respuesta y un playground interactivo.