> ## 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 Supremo de Justicia

> Busque na jurisprudência do Tribunal Supremo de Justicia da Bolívia, cerca de 90.000 autos supremos, sentenças e resoluções de suas salas desde 2001, com as notas de jurisprudência do Tribunal; leia qualquer uma completa.

O Tribunal Supremo de Justicia é o tribunal máximo da jurisdição ordinária da Bolívia. Suas salas (Civil, Penal, Social, Contenciosa y Contenciosa Administrativa, a Sala Plena e as salas liquidatárias que encerraram o acervo da antiga Corte) publicaram cerca de 90.000 resoluções desde 2001. Cada uma chega aqui com seu texto completo, os números da resolução e do processo, a sala, o tipo de resolução e como foi resolvida, a matéria, o departamento de origem, o ministro relator, as notas de jurisprudência que o Tribunal extraiu dela (descritor, restritor, ratio decidendi, máxima, síntese e precedente), o documento como o Tribunal o publicou e um link para a resolução no site do Tribunal.

Busque em todas de uma vez, por sala, tipo de resolução, matéria, resultado, número da resolução ou do processo, ministro relator, departamento, ano ou data, ou com texto livre que alcança as notas e o corpo de cada resolução. Cada sala numera suas resoluções a partir de um a cada ano, então um número pode pertencer a várias salas; `id` identifica uma única 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/tsj-bo/rulings-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma única busca sobre o texto completo e as notas de jurisprudência de todas as resoluções desde 2001, filtrada por sala, tipo de resolução, matéria, resultado, número, ministro relator, departamento, ano ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas nos números da resolução e do processo, na sala, na matéria, no resultado, nas notas de jurisprudência e no texto completo. |
| `chamber` | string | Sala opcional como `chamber` a nomeia, p. ex. `Sala Civil`, `Sala Penal`, `Sala Plena` ou `Sala Social`, comparado desde o início. Maiúsculas e acentos são ignorados. |
| `type` | enum | Tipo de resolução opcional: `auto_supremo`, `sentencia` ou `resolucion`. |
| `subject` | string | Matéria opcional como `subject` a nomeia, p. ex. `Civil`, `Penal`, `Familia`, `Social`, `Agrario`, comparada desde o início. Maiúsculas e acentos são ignorados. |
| `outcome` | string | Resultado opcional como `outcome` o nomeia, p. ex. `Infundado`, `Casa`, `Improcedente`, `Anula`, comparado 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. `AS/0001/2013` ou `SE/0001/2023`. Cada sala numera suas próprias resoluções, então um número pode retornar várias; adicione `chamber` para restringir. Maiúsculas, espaços e sinais são ignorados. |
| `case_number` | string | Número do processo (expediente) opcional, como o Tribunal o imprime. Maiúsculas, espaços e sinais são ignorados. |
| `reporting_judge` | string | Ministro relator opcional como `reporting_judge` o nomeia, comparado desde o início. Maiúsculas e acentos são ignorados. |
| `department` | string | Departamento de origem opcional, p. ex. `La Paz`, `Santa Cruz`, `Chuquisaca`, 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/tsj-bo/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "query": "nulidad de contrato",
        "chamber": "Sala Civil",
        "type": "auto_supremo"
      }'
```

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. `11378`), `registration_number` (o número da resolução, p. ex. `AS/0001/2010`), `case_number` (o processo), `ruling_date`, `year`, `chamber` (a sala), `type` (`auto_supremo`, `sentencia` ou `resolucion`) com `type_label` e `subtype`, `outcome` (a forma de resolução, p. ex. `Infundado`, `Casa`), `subject` (a matéria), `proceeding`, `department`, `reporting_judge` (o ministro relator), `jurisprudence` (as notas de jurisprudência do Tribunal, cada uma com `kind`, `descriptor`, `restrictor`, `ratio_decidendi`, `maxim`, `summary` e `precedent`), `descriptors`, `text_status` (`ok`, `scanned` ou `missing`), `document_kind` (`scan`, `rendering` ou `none`), `official_url` (a página da resolução no site do Tribunal), `document_url` (a cópia da Croma do documento, idêntica byte a byte à que o Tribunal entregou, que continua disponível aconteça o que acontecer com o link do Tribunal) e `source_document_url` (onde o Tribunal publica o documento: o link do escaneamento, ou a página da resolução). Os campos que o Tribunal deixa vazios vêm como null ou listas vazias; nomes das partes nunca são incluídos.

<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 Supremo de Justicia de Bolivia Ruling.
</Note>

## Uma resolução, completa

`POST /bo/tsj-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. `11378`, 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/tsj-bo/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "11378" }'
```

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. `11378`), `registration_number` (o número da resolução, p. ex. `AS/0001/2010`), `case_number` (o processo), `ruling_date`, `year`, `chamber` (a sala), `type` (`auto_supremo`, `sentencia` ou `resolucion`) com `type_label` e `subtype`, `outcome` (a forma de resolução, p. ex. `Infundado`, `Casa`), `subject` (a matéria), `proceeding`, `department`, `reporting_judge` (o ministro relator), `jurisprudence` (as notas de jurisprudência do Tribunal, cada uma com `kind`, `descriptor`, `restrictor`, `ratio_decidendi`, `maxim`, `summary` e `precedent`), `descriptors`, `text_status` (`ok`, `scanned` ou `missing`), `document_kind` (`scan`, `rendering` ou `none`), `official_url` (a página da resolução no site do Tribunal), `document_url` (a cópia da Croma do documento, idêntica byte a byte à que o Tribunal entregou, que continua disponível aconteça o que acontecer com o link do Tribunal) e `source_document_url` (onde o Tribunal publica o documento: o link do escaneamento, ou a página da resolução). Os campos que o Tribunal deixa vazios vêm como null ou listas vazias; nomes das partes nunca são incluídos.

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