Skip to main content
A relatoría do Consejo de Estado titula cada decisão que publica no SAMAI: sentencias, autos, aclaraciones e salvamentos de voto e conceptos, cada uma com suas ementas (descritores do tesauro, o problema jurídico e sua resposta, a tese, as fontes formais e as notas da relatoría). Cada decisão datada desde dezembro de 2021 chega aqui com essas ementas, o texto completo, o documento e um link para o processo no site da corte. Busque em todas de uma vez, por seção, tipo, ano, radicado, relator, partes ou data, ou com texto livre que alcança as ementas e o corpo de cada decisão. Busque primeiro e 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.

​
Buscar decisões

POST /co/samai-rulings/search/v1 Dataset Uma única busca sobre as ementas e o texto completo de todas as decisões do Consejo de Estado desde dezembro de 2021, filtrada por seção, tipo, ano, radicado, relator, partes ou data.
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 certificado de 64 caracteres do documento da decisão), registration_number (o radicado de 23 dígitos; um processo agrupa várias decisões), internal_number, chamber e chamber_key, type e type_key, proceeding_class (o medio de control), action, ruling_date, filing_date (quando o processo chegou ao Consejo de Estado), year, reporting_judges[] e reporting_judge_keys[], plaintiff e defendant com suas variantes *_key, as ementas da relatoría (descriptors[], legal_problem, legal_problem_answer, thesis, formal_sources[], relatoria_note, e headnotes[] com cada ementa separada), text_status, document_format, document_url (o documento da decisão, PDF, ou Word em algumas das mais antigas, sempre disponível) e official_url (a página do processo no site do Consejo de Estado).
Os resultados da busca não incluem o texto da decisão. query busca dentro dele, então uma frase do corpo encontra a decisão; para ler o texto use o endpoint SAMAI Ruling.

​
Uma decisão, completa

POST /co/samai-rulings/ruling/v1 Dataset
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 certificado de 64 caracteres do documento da decisão), registration_number (o radicado de 23 dígitos; um processo agrupa várias decisões), internal_number, chamber e chamber_key, type e type_key, proceeding_class (o medio de control), action, ruling_date, filing_date (quando o processo chegou ao Consejo de Estado), year, reporting_judges[] e reporting_judge_keys[], plaintiff e defendant com suas variantes *_key, as ementas da relatoría (descriptors[], legal_problem, legal_problem_answer, thesis, formal_sources[], relatoria_note, e headnotes[] com cada ementa separada), text_status, document_format, document_url (o documento da decisão, PDF, ou Word em algumas das mais antigas, sempre disponível) e official_url (a página do processo no site do Consejo de Estado).
As decisões longas chegam a dezenas 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. content é null quando text_status não é extracted; document_url continua trazendo o documento.
Um id que não está na relatoría retorna found: false com HTTP 200, não um erro. A relatoría titula uma decisão semanas ou meses depois de proferida, 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.