> ## 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.

# Tribunal Constitucional

> As sentenças do Tribunal Constitucional do Chile: busque em cerca de 13.000 causas desde 1981 por rol, procedimento, resultado ou data, e leia qualquer sentença completa com sua ficha, seus votos e seu PDF original.

O Tribunal Constitucional do Chile decide se as leis e outras normas estão de acordo com a Constituição: pedidos para declarar inaplicável um preceito legal num processo pendente (a inaplicabilidad, a maior parte de seu trabalho), declarações de inconstitucionalidade, o controle preventivo de leis orgânicas e as impugnações de autos acordados, decretos e projetos de lei. Cada causa chega aqui como um rol com seu procedimento, a data da sentença, o resultado, quem a apresentou e o processo de onde vem, os preceitos legais impugnados e os artigos da Constituição em jogo, as palavras-chave e a doutrina do Tribunal, os ministros da maioria, da divergência e de qualquer prevención com quem redigiu cada um, cada ficha do buscador de jurisprudência do Tribunal para a causa e cada documento distinto da causa, guardado byte a byte, com o texto da sentença.

As sentenças recentes chegam no dia seguinte à assinatura pelo Tribunal, com o PDF assinado e a carátula; a ficha chega quando o buscador de jurisprudência do Tribunal se atualiza, normalmente uns três meses depois. Busque por rol, procedimento, resultado ou data, ou com texto livre que alcança os preceitos, os ministros e a própria sentença. Busque primeiro e depois leia uma causa completa.

> [!NOTE]
>
> 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](https://docs.usecroma.com/pt/datasets.md).

## Buscar sentenças

`POST /cl/tc-cl/rulings-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

Uma única busca sobre todas as causas do Tribunal Constitucional com sentença publicada desde 1981, filtrada por rol, procedimento, resultado ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nos requerentes, na gestão pendente, nas leis impugnadas, nos artigos da Constituição, nas palavras-chave, nos ministros, na doutrina e no texto da sentença, p. ex. `debido proceso`. Todas as palavras devem aparecer. |
| `rol` | string | Rol opcional da causa, p. ex. `16770`. `16.770-25-INA` também funciona: só conta o número. |
| `procedure` | string | Código de procedimento opcional: `INA` (inaplicabilidad), `INC` (inconstitucionalidad), `CPR` (controle preventivo), `CAA` (autos acordados), `CPT`, `CDS` e os demais. |
| `outcome` | string | Resultado opcional como o Tribunal o registra, p. ex. `Acoge`, `Rechaza`, `Acoge parcialmente`. Acentos e maiúsculas não importam. |
| `from_date` | string | Opcional: só causas cuja última sentença é desta data ou posterior, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só causas cuja última sentença é desta data ou anterior, `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/cl/tc-cl/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "debido proceso", "procedure": "INA" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, da sentença mais recente à mais antiga. Cada resultado é uma causa: `rol` (o número da causa, p. ex. `16770`), `case_number` (com seu ano de ingresso, p. ex. `17637-2026`, nas sentenças recentes), `procedure` (p. ex. `INA`) e `procedure_name`, `ruling_type` (p. ex. `INA-STC`), `sentence_date` e `sentence_date_raw` (a data como o Tribunal a registra, mantida mesmo quando escrita errada; `sentence_date` fica então null) e `year`, `caption` (a carátula, nas sentenças recentes), `outcome` e `outcomes`, `resolution_types`, `requesters` (requerentes), `pending_proceeding` (gestão pendente), `challenged_provisions` (cada um com `legal_body`, `article`, `paragraph`, `number`, `letter`, `section`, `phrase` e `text`) e `challenged_laws`, `constitutional_articles`, `keywords`, `majority` e `majority_author`, `dissent` e `dissent_author`, `concurrence` e `concurrence_author` (prevención), `bench`, `chamber`, `related_rulings`, `doctrine`, `justices` (todos os ministros citados na causa), `fichas` (cada ficha do buscador de jurisprudência do Tribunal para a causa, com `id`, `type`, `type_name`, `sentence_date`, `status`, `updated_at` e cada um de seus `fields` com seu `name` e seus `values`), `documents` (cada documento distinto da causa, com `id`, `collection`: `case_file` para a sentença assinada ou `case_law` para a cópia do buscador de jurisprudência, `name`, `date`, `pages`, `bytes`, `text_status`, `document_url`, a cópia idêntica byte a byte da Croma, e `source_document_url`), `text_status`, `document_url` e `source_document_url` (os do primeiro documento). Os campos que o Tribunal não indica vêm como null ou vazios.

> [!NOTE]
>
> Os resultados da busca não incluem o texto da sentença. `query` busca dentro dele; para ler o texto use o endpoint Tribunal Constitucional Chile Ruling.

> [!NOTE]
>
> Uma sentença nova aparece no dia seguinte à assinatura pelo Tribunal, com seu PDF assinado e sua carátula. Sua ficha (resultado, preceitos, votos, doutrina) chega quando o buscador de jurisprudência do Tribunal se atualiza, normalmente uns três meses depois.

## Uma causa, completa

`POST /cl/tc-cl/ruling/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

| Campo | Tipo | Notas |
| - | - | - |
| `rol` | string | **Obrigatório.** O `rol` da causa retornado pela busca, p. ex. `16770`. `16.770-25` ou `16770-2025-INA` também funcionam: só conta o número. |
| `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 sentenças cabe em uma resposta. Por padrão `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/tc-cl/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rol": "16770" }'
```

Retorna `as_of`, `found`, `rol` e `ruling`, que traz tudo o que a busca retorna mais `content` (uma janela sobre o texto da sentença, com `text`, `offset`, `total_length`, `has_more` e `next_offset`). Cada resultado é uma causa: `rol` (o número da causa, p. ex. `16770`), `case_number` (com seu ano de ingresso, p. ex. `17637-2026`, nas sentenças recentes), `procedure` (p. ex. `INA`) e `procedure_name`, `ruling_type` (p. ex. `INA-STC`), `sentence_date` e `sentence_date_raw` (a data como o Tribunal a registra, mantida mesmo quando escrita errada; `sentence_date` fica então null) e `year`, `caption` (a carátula, nas sentenças recentes), `outcome` e `outcomes`, `resolution_types`, `requesters` (requerentes), `pending_proceeding` (gestão pendente), `challenged_provisions` (cada um com `legal_body`, `article`, `paragraph`, `number`, `letter`, `section`, `phrase` e `text`) e `challenged_laws`, `constitutional_articles`, `keywords`, `majority` e `majority_author`, `dissent` e `dissent_author`, `concurrence` e `concurrence_author` (prevención), `bench`, `chamber`, `related_rulings`, `doctrine`, `justices` (todos os ministros citados na causa), `fichas` (cada ficha do buscador de jurisprudência do Tribunal para a causa, com `id`, `type`, `type_name`, `sentence_date`, `status`, `updated_at` e cada um de seus `fields` com seu `name` e seus `values`), `documents` (cada documento distinto da causa, com `id`, `collection`: `case_file` para a sentença assinada ou `case_law` para a cópia do buscador de jurisprudência, `name`, `date`, `pages`, `bytes`, `text_status`, `document_url`, a cópia idêntica byte a byte da Croma, e `source_document_url`), `text_status`, `document_url` e `source_document_url` (os do primeiro documento). Os campos que o Tribunal não indica vêm como null ou vazios.

> [!NOTE]
>
> As sentenças longas são lidas por intervalos: envie `offset` e `limit`, depois passe o `next_offset` da resposta como `offset` até que `has_more` seja falso.

> [!NOTE]
>
> Um rol para o qual o Tribunal não publicou sentença retorna `found: false` com HTTP 200, não um erro.

> **[Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)**
>
> Esquemas, todos os campos de resposta e um playground interativo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.