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

# Courts of Japan (裁判例)

> A jurisprudência dos tribunais do Japão: busque em cerca de 68.000 decisões da Suprema Corte e dos tribunais superiores e inferiores desde 1947, e leia qualquer uma completa com seu documento original.

A Suprema Corte do Japão publica a jurisprudência que os tribunais selecionam para seus repertórios: as sentenças e decisões da própria Suprema Corte, os repertórios dos tribunais superiores, o boletim dos tribunais inferiores e as coleções de casos administrativos, trabalhistas e de propriedade intelectual, cerca de 68.000 decisões desde 1947. Cada uma chega aqui com seu número e nome de caso, o tribunal e a turma, a data, o tipo de decisão e seu resultado, a decisão do tribunal inferior, o resumo do próprio tribunal e as normas que cita quando o tribunal os publica, o texto completo lido do documento do tribunal, o documento como o tribunal o publicou e um link para sua página nos tribunais.

Busque em todas as coleções de uma vez, por coleção, tribunal, número do caso, ano ou data, ou com texto livre em japonês que alcança os resumos e o corpo de cada decisã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 decisões

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

Uma única busca sobre todas as coleções de jurisprudência dos tribunais desde 1947, filtrada por coleção, tribunal, número do caso, ano ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais em japonês, buscadas no nome do caso, no resumo do tribunal, nas normas citadas e no texto, p. ex. `解雇権濫用` ou `過払金 返還`. Dois ou mais caracteres; todas as palavras devem aparecer. |
| `collection` | enum | Coleção opcional: `supreme`, `high`, `lower`, `administrative`, `labor`, `ip` ou `ip_high`. |
| `court` | string | Tribunal opcional como `court` o nomeia, p. ex. `最高裁判所第一小法廷`, `東京高等裁判所`, `大阪地方裁判所`, comparado desde o início: `最高裁判所` encontra todas as turmas. |
| `case_number` | string | Número do caso opcional como o tribunal o imprime, p. ex. `平成21(オ)257`. Espaços e a largura dos caracteres são ignorados. |
| `year` | integer | Ano da decisão opcional. 0 busca em todos os anos. Por padrão `0`. |
| `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/jp/courts-jp/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "解雇権濫用", "collection": "supreme" }'
```

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 decisão mais recente à mais antiga. Cada resultado traz `id` (o número permanente da decisão no site dos tribunais, p. ex. `93117`), `collections` (`supreme`, `high`, `lower`, `administrative`, `labor`, `ip`, `ip_high`; uma decisão pode estar em várias), `case_number` (p. ex. `平成21(オ)257`) e `case_year`, `title` (o nome do caso), `ruling_date` e `ruling_date_japanese`, `year`, `court` (com a turma para a Suprema Corte), `branch`, `department`, `judgment_type` (判決, 決定), `result` (棄却, 破棄差戻...), `reporter` (a citação nos repertórios oficiais), a decisão do tribunal inferior (`lower_court`, `lower_case_number`, `lower_ruling_date`, `lower_result`), o resumo do próprio tribunal quando o publica (`holding` para 判示事項, `gist` para 裁判要旨, `statutes` para 参照法条), `field`, os campos de propriedade intelectual (`right_type`, `suit_type`, `ip_case_kind`, `invention`, `issues`, `appeal`, `appeal_result`, `ip_result`), `text_status` (`ok`, `scanned` ou `missing`), `official_url` (a página da decisão nos tribunais), `document_url` (a cópia da Croma do documento do tribunal, idêntica byte a byte) e `source_document_url` (o link próprio do documento nos tribunais). Os campos que o tribunal não indica vêm como null; os nomes das partes nunca são campos.

<Note>
  Os resultados da busca não incluem o texto. `query` busca dentro dele, então uma frase do corpo encontra a decisão; para ler o texto use o endpoint Courts of Japan Ruling.
</Note>

## Uma decisão, completa

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

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

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

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 número permanente da decisão no site dos tribunais, p. ex. `93117`), `collections` (`supreme`, `high`, `lower`, `administrative`, `labor`, `ip`, `ip_high`; uma decisão pode estar em várias), `case_number` (p. ex. `平成21(オ)257`) e `case_year`, `title` (o nome do caso), `ruling_date` e `ruling_date_japanese`, `year`, `court` (com a turma para a Suprema Corte), `branch`, `department`, `judgment_type` (判決, 決定), `result` (棄却, 破棄差戻...), `reporter` (a citação nos repertórios oficiais), a decisão do tribunal inferior (`lower_court`, `lower_case_number`, `lower_ruling_date`, `lower_result`), o resumo do próprio tribunal quando o publica (`holding` para 判示事項, `gist` para 裁判要旨, `statutes` para 参照法条), `field`, os campos de propriedade intelectual (`right_type`, `suit_type`, `ip_case_kind`, `invention`, `issues`, `appeal`, `appeal_result`, `ip_result`), `text_status` (`ok`, `scanned` ou `missing`), `official_url` (a página da decisão nos tribunais), `document_url` (a cópia da Croma do documento do tribunal, idêntica byte a byte) e `source_document_url` (o link próprio do documento nos tribunais). Os campos que o tribunal não indica vêm como null; os nomes das partes nunca são campos.

<Note>
  As decisõ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 do tribunal.
</Note>

<Note>
  Um `id` que os tribunais não publicaram 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.