> ## 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
> Busque em todas as decisões da Corte Suprema de Justiça da Colômbia desde 1886, de todas as salas e com as tutelas, e leia o texto completo de qualquer uma.
A Corte Suprema de Justicia é o tribunal mais alto da Colômbia em matéria cível, agrária, trabalhista e penal. Sua relatoría reúne mais de 660.000 decisões, de 1886 a esta semana: acórdãos de cassação, autos e decisões de tutela das salas cível, trabalhista e penal, do pleno e das salas históricas constitucional e de negócios gerais. Cada uma chega aqui com sua sala, o tipo de decisão e de procedimento, o número do processo, o magistrado relator, o resumo e os descritores da relatoría, o texto completo quando a Corte o publica e um link para o documento da decisão na Corte.
Busque em todas de uma vez, por sala, tipo, tutela ou não, ano, processo, relator ou data, ou com texto livre que alcança o corpo de cada decisão. Primeiro busque, depois leia uma decisão completa.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar decisões
`POST /co/corte-suprema/rulings-search/v1` Dataset
Uma única busca sobre o texto completo de todas as decisões desde 1886, filtrada por sala, tipo, tutela, ano, processo, relator ou data.
| Campo | Tipo | Notas |
| --------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palavras opcionais buscadas no número da decisão, no processo, no relator, no resumo, nos descritores e no texto completo. |
| `chamber` | string | Sala opcional: `civil`, `laboral`, `penal`, `plena`, ou as históricas `constitucional` e `negocios-generales`. `penal` inclui as salas especiais da sala penal; `laboral`, as salas de descongestionamento. |
| `type` | string | Tipo de decisão opcional, como a Corte o nomeia: `SENTENCIA`, `AUTO`, `AUTO INTERLOCUTORIO`. Corresponde ao início do nome, então `AUTO` encontra todos os tipos de auto. Maiúsculas são ignoradas. |
| `is_tutela` | boolean,null | Opcional: `true` só para decisões de tutela, `false` só para os assuntos próprios das salas. Omita para ambos. Por padrão `null`. |
| `year` | integer | Ano opcional da decisão. 0 busca em todos os anos. Por padrão `0`. |
| `registration_number` | string | Número do processo (radicado) opcional: `11001-02-03-000-2026-04999-00`, ou os mesmos dígitos sem hífens. Só os dígitos são comparados. |
| `reporting_judge` | string | Magistrado relator opcional, pelo nome completo como aparece em `reporting_judges`. Maiúsculas e acentos são ignorados. |
| `from_date` | string | Opcional: só decisões proferidas nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só decisões proferidas nesta data ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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" }'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `results[]`, da decisão mais recente à mais antiga. Cada resultado traz `id` (o identificador da relatoría, p. ex. `978662`), `number` (como a Corte o imprime, p. ex. `AC6049-2026`), `type`, `proceeding_class`, `chamber` e `chamber_group`, `is_tutela`, `registration_number` (o radicado) e `registration_digits`, `reporting_judges[]` e `reporting_judge_keys[]`, `year`, `ruling_date`, `subject` (o resumo da relatoría), `descriptors[]`, `text_status`, `text_source` e `official_url` (o documento da decisão como a Corte o publica).
Os resultados da busca não incluem o texto da decisão: uma única decisão pode ter centenas de milhares de caracteres. `query` busca dentro dele, então uma frase do corpo encontra a decisão; para ler o texto use o endpoint Corte Suprema Ruling.
## Uma decisão, completa
`POST /co/corte-suprema/ruling/v1` Dataset
| Campo | Tipo | Notas |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão em um resultado de busca (`978662`), ou seu número como a Corte o imprime (`AC6049-2026`, `SL1234-2024`, `STC5959-2026`). Maiúsculas e espaços são ignorados. |
| `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit` | integer | Quantos caracteres do texto retornar. A maioria das decisões cabe em uma resposta; as mais longas têm centenas de milhares de caracteres. Por padrão `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" }'
```
Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo da decisão, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o identificador da relatoría, p. ex. `978662`), `number` (como a Corte o imprime, p. ex. `AC6049-2026`), `type`, `proceeding_class`, `chamber` e `chamber_group`, `is_tutela`, `registration_number` (o radicado) e `registration_digits`, `reporting_judges[]` e `reporting_judge_keys[]`, `year`, `ruling_date`, `subject` (o resumo da relatoría), `descriptors[]`, `text_status`, `text_source` e `official_url` (o documento da decisão como a Corte o publica).
As decisões longas têm centenas de milhares de caracteres, então o texto é lido por intervalos: envie `offset` e `limit`, depois passe o `next_offset` da resposta como `offset` até que `has_more` seja falso.
`text_status` diz se o texto completo está aqui: `extracted` significa que sim; `scanned`, que o documento da Corte é uma imagem digitalizada sem texto, e `content` é null; `unavailable`, que a Corte não publica documento da decisão, como acontece com muitas decisões históricas. `official_url` sempre aponta para a decisão na Corte.
Um id ou número que a relatoría não tem retorna `found: false` com HTTP 200, não um erro. A Corte publica uma decisão semanas ou meses depois de proferi-la, então uma decisão recente pode retornar `found: false` hoje e aparecer depois.
Esquemas, todos os campos de resposta e um playground interativo.