> ## 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. # SAMAI Relatoría > Busque em todas as decisões do Consejo de Estado desde dezembro de 2021 pelas ementas, texto completo, seção, tipo, relator, partes ou data, e leia qualquer uma com seu texto completo e seu documento. 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](/pt/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. | Campo | Tipo | Notas | | --------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `query` | string | Palavras opcionais buscadas nas ementas (descritores, problema jurídico, tese, fontes, nota da relatoría), no radicado, nas partes e no texto completo. | | `chamber` | string | Seção ou sala opcional, comparada desde o início do nome: `Sección Tercera` também traz suas subsecciones, `Sala de Consulta`. Maiúsculas e acentos são ignorados. | | `type` | string | Tipo de decisão opcional, comparado desde o início do nome: `Sentencia`, `Auto` (todos os autos), `Salvamento voto`, `Aclaración voto`. Maiúsculas e acentos são ignorados. | | `year` | integer | Ano opcional da data da decisão. 0 busca em todos os anos. Por padrão `0`. | | `registration_number` | string | Radicado opcional de 23 dígitos. Espaços, pontos e hífens são ignorados. | | `reporting_judge` | string | Conselheiro relator opcional, pelo nome completo como aparece em `reporting_judges`. Maiúsculas e acentos são ignorados. | | `plaintiff` | string | Demandante opcional, comparado desde o início do nome como a corte o registra. Maiúsculas e acentos são ignorados. | | `defendant` | string | Demandado opcional, comparado desde o início do nome como a corte o registra. 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/samai-rulings/search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "reparación directa", "chamber": "Sección Tercera" }' ``` 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 | Campo | Tipo | Notas | | ----------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `ruling_id` | string | **Obrigatório.** O `id` da decisão em um resultado de busca: o certificado hexadecimal de 64 caracteres do seu documento. Maiúsculas são ignoradas. | | `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. Por padrão `200000`. | ```bash theme={"dark"} curl https://api.croma.run/co/samai-rulings/ruling/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ruling_id": "8C5E75723C249F020E54B1D2B2BCB0735566D537789B23F23B1373B33F24F21F" }' ``` 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. Esquemas, todos os campos de resposta e um playground interativo.