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

> Busque em cerca de 99.000 resoluções do Tribunal Constitucional Plurinacional da Bolívia e de seu antecessor desde 1999, e leia qualquer uma completa com seu documento original.

O Tribunal Constitucional Plurinacional da Bolívia publica cada resolução que profere, e as do Tribunal Constitucional que o precedeu entre 1999 e 2010: cerca de 99.000 sentenças, autos, declarações e votos sobre amparo, liberdade, inconstitucionalidade, conflitos de competência e o controle de constitucionalidade de leis e estatutos autonômicos. Cada uma chega aqui com seu texto completo, o número da resolução, a sala, o ministro relator, a ação constitucional, o departamento de origem, seus processos, o documento original como o Tribunal o publicou e um link para sua página no Tribunal.

Busque em todas de uma vez, por tipo de resolução, sala, ação, ministro relator, departamento, número da resolução ou do processo, ano ou data, ou com texto livre que alcança o corpo de cada resolução.

<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](/pt/datasets).
</Note>

## Buscar resoluções

`POST /bo/tcp-bo/rulings-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma única busca sobre o texto completo de todas as resoluções constitucionais desde 1999, filtrada por tipo, sala, ação, ministro relator, departamento, número, ano ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no número da resolução, nos processos, na sala, na ação e no texto completo. |
| `type` | enum | Tipo de resolução opcional: `sentencia`, `auto`, `declaracion`, `voto_disidente`, `voto_aclaratorio` ou `decreto`. |
| `chamber` | string | Sala opcional como `chamber` a nomeia, p. ex. `Sala Primera`, `Sala Plena` ou `Comisión de Admisión`, comparada desde o início. Maiúsculas e acentos são ignorados. |
| `proceeding_type` | string | Ação constitucional opcional como `proceeding_type` a nomeia, p. ex. `Acción de amparo constitucional`, `Acción de libertad` ou `Recurso de habeas corpus`, comparada desde o início. Maiúsculas e acentos são ignorados. |
| `registration_number` | string | Número da resolução opcional, como o Tribunal o imprime, p. ex. `0049/2024-S2`. Retorna todas as resoluções desse número, incluídos os votos que a acompanham. Maiúsculas, zeros à esquerda, espaços e sinais são ignorados. |
| `case_number` | string | Número do processo (expediente) opcional, p. ex. `52034-2022-105-AL`. Maiúsculas, espaços e sinais são ignorados. |
| `reporting_judge` | string | Ministro relator opcional, comparado desde o início do nome sem títulos, p. ex. `Carlos Alberto Calderón`. Maiúsculas e acentos são ignorados. |
| `department` | string | Departamento de origem opcional, p. ex. `La Paz`, `Santa Cruz` ou `Cochabamba`, comparado desde o início. Maiúsculas e acentos são ignorados. |
| `year` | integer | Ano da resolução opcional. 0 busca em todos os anos. Por padrão `0`. |
| `from_date` | string | Opcional: só resoluções proferidas nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só resoluçõ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/bo/tcp-bo/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "query": "debido proceso",
        "type": "sentencia",
        "proceeding_type": "Acción de amparo"
      }'
```

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 resolução mais recente à mais antiga. Cada resultado traz `id` (o número permanente da resolução, p. ex. `202697`), `registration_number` (o número da resolução como o Tribunal o imprime, p. ex. `0049/2024-S2`), `type` (`sentencia`, `auto`, `declaracion`, `voto_disidente`, `voto_aclaratorio` ou `decreto`), `type_label` (o rótulo do próprio Tribunal), `ruling_date`, `year`, `chamber` (p. ex. `SALA SEGUNDA`, `SALA PLENA`, `COMISIÓN DE ADMISIÓN`), `proceeding_type` (a ação constitucional), `reporting_judge`, `department`, `case_numbers` (os processos que decide), `text_status` (`ok`, `scanned` ou `missing`), `official_url` (a página da resolução no Tribunal), `document_url` (a cópia da Croma do documento original, idêntica byte a byte à que o Tribunal publicou) e `source_document_url` (sempre null: o Tribunal não dá a seus documentos um link próprio). Os campos que a resolução não indica vêm como null ou listas vazias; nomes das partes nunca são incluídos como campos.

<Note>
  Os resultados da busca não incluem o texto. `query` busca dentro dele, então uma frase do corpo encontra a resolução; para ler o texto use o endpoint Tribunal Constitucional Plurinacional de Bolivia Ruling.
</Note>

## Uma resolução, completa

`POST /bo/tcp-bo/ruling/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da resolução retornado pela busca, p. ex. `202697`, ou sua `official_url`. |
| `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 resoluções cabe em uma resposta. Por padrão `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/bo/tcp-bo/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "202697" }'
```

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 resolução, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o número permanente da resolução, p. ex. `202697`), `registration_number` (o número da resolução como o Tribunal o imprime, p. ex. `0049/2024-S2`), `type` (`sentencia`, `auto`, `declaracion`, `voto_disidente`, `voto_aclaratorio` ou `decreto`), `type_label` (o rótulo do próprio Tribunal), `ruling_date`, `year`, `chamber` (p. ex. `SALA SEGUNDA`, `SALA PLENA`, `COMISIÓN DE ADMISIÓN`), `proceeding_type` (a ação constitucional), `reporting_judge`, `department`, `case_numbers` (os processos que decide), `text_status` (`ok`, `scanned` ou `missing`), `official_url` (a página da resolução no Tribunal), `document_url` (a cópia da Croma do documento original, idêntica byte a byte à que o Tribunal publicou) e `source_document_url` (sempre null: o Tribunal não dá a seus documentos um link próprio). Os campos que a resolução não indica vêm como null ou listas vazias; nomes das partes nunca são incluídos como campos.

<Note>
  As resoluções 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. `content` é null quando `text_status` não é `ok`; `document_url` continua entregando o documento original quando o Tribunal publicou um.
</Note>

<Note>
  Um `id` que o Tribunal não publicou retorna `found: false` com HTTP 200, não um erro.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


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