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.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.
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
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.Referência completa
Esquemas, todos os campos de resposta e um playground interativo.