> ## 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 Suprema de Justicia
> Busca en todas las providencias de la Corte Suprema de Justicia de Colombia desde 1886, de todas las salas y con las tutelas, y lee el texto completo de cualquiera.
La Corte Suprema de Justicia es el máximo tribunal de Colombia en materia civil, agraria, laboral y penal. Su relatoría reúne más de 660.000 providencias, de 1886 a esta semana: sentencias de casación, autos y decisiones de tutela de las salas civil, laboral y penal, de la sala plena y de las salas históricas constitucional y de negocios generales. Cada una llega aquí con su sala, el tipo de providencia y de actuación, el radicado, el magistrado ponente, el tema y los descriptores de la relatoría, el texto completo cuando la Corte lo publica y un enlace al documento de la providencia en la Corte.
Busca en todas a la vez, por sala, tipo, tutela o no, año, radicado, ponente o fecha, o con texto libre que llega hasta el cuerpo de cada providencia. Primero busca, luego lee una providencia completa.
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-suprema/rulings-search/v1` Dataset
Una sola búsqueda sobre el texto completo de todas las providencias desde 1886, filtrada por sala, tipo, tutela, año, radicado, ponente o fecha.
| Campo | Tipo | Notas |
| --------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palabras opcionales que se buscan en el número de la providencia, el radicado, el ponente, el tema, los descriptores y el texto completo. |
| `chamber` | string | Sala opcional: `civil`, `laboral`, `penal`, `plena`, o las históricas `constitucional` y `negocios-generales`. `penal` incluye las salas especiales de la sala penal; `laboral`, sus salas de descongestión. |
| `type` | string | Tipo de providencia opcional, como lo nombra la Corte: `SENTENCIA`, `AUTO`, `AUTO INTERLOCUTORIO`. Coincide con el inicio del nombre, así que `AUTO` encuentra todos los tipos de auto. No importan mayúsculas. |
| `is_tutela` | boolean,null | Opcional: `true` solo para decisiones de tutela, `false` solo para asuntos de sala. Omítelo para ambos. Por defecto `null`. |
| `year` | integer | Año opcional de la providencia. 0 busca en todos los años. Por defecto `0`. |
| `registration_number` | string | Radicado opcional: `11001-02-03-000-2026-04999-00`, o los mismos dígitos sin guiones. Solo se comparan los dígitos. |
| `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-suprema/rulings-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "prescripción adquisitiva", "chamber": "civil" }'
```
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 identificador de la relatoría, p. ej. `978662`), `number` (como lo imprime la Corte, p. ej. `AC6049-2026`), `type`, `proceeding_class`, `chamber` y `chamber_group`, `is_tutela`, `registration_number` (el radicado) y `registration_digits`, `reporting_judges[]` y `reporting_judge_keys[]`, `year`, `ruling_date`, `subject` (el tema de la relatoría), `descriptors[]`, `text_status`, `text_source` y `official_url` (el documento de la providencia como lo publica 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 Suprema Ruling.
## Una providencia, completa
`POST /co/corte-suprema/ruling/v1` Dataset
| Campo | Tipo | Notas |
| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ruling_id` | string | **Obligatorio.** El `id` de la providencia en un resultado de búsqueda (`978662`), o su número como lo imprime la Corte (`AC6049-2026`, `SL1234-2024`, `STC5959-2026`). No importan mayúsculas ni espacios. |
| `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 tienen cientos de miles de caracteres. Por defecto `200000`. |
```bash theme={"dark"}
curl https://api.croma.run/co/corte-suprema/ruling/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "ruling_id": "AC6049-2026" }'
```
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 identificador de la relatoría, p. ej. `978662`), `number` (como lo imprime la Corte, p. ej. `AC6049-2026`), `type`, `proceeding_class`, `chamber` y `chamber_group`, `is_tutela`, `registration_number` (el radicado) y `registration_digits`, `reporting_judges[]` y `reporting_judge_keys[]`, `year`, `ruling_date`, `subject` (el tema de la relatoría), `descriptors[]`, `text_status`, `text_source` y `official_url` (el documento de la providencia como lo publica la Corte).
Las providencias largas tienen cientos de miles 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.
`text_status` dice si el texto completo está aquí: `extracted` significa que sí; `scanned`, que el documento de la Corte es una imagen escaneada sin texto, y `content` es null; `unavailable`, que la Corte no publica documento de la providencia, como ocurre con muchas providencias históricas. `official_url` siempre enlaza la providencia en la Corte.
Un id o un número que la relatoría no tiene devuelve `found: false` con HTTP 200, no un error. La Corte publica una providencia semanas o meses después de proferirla, así que una reciente puede dar `found: false` hoy y aparecer después.
Esquemas, todos los campos de respuesta y un playground interactivo.