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

# Poder Judicial

> A jurisprudência dos tribunais do Chile: busque em cerca de 4,65 milhões de decisões da Corte Suprema, das Cortes de Apelaciones e dos tribunais cíveis, penais, de família, trabalhistas e de cobrança, e leia qualquer uma completa.

O Poder Judicial do Chile publica as decisões de seus tribunais: cerca de 4,65 milhões que qualquer pessoa pode ler, em sete coleções. A Corte Suprema (cerca de 310.000 desde 2005) e as 17 Cortes de Apelaciones (cerca de 2 milhões desde 2000) publicam em um dia. Seguem cinco jurisdições de primeira instância: cível (cerca de 856.000), penal (cerca de 840.000), família (cerca de 373.000), trabalhista (cerca de 236.000) e cobrança trabalhista e previdenciária (cerca de 26.000), que publicam meses ou anos depois de decidir, em lotes.

Cada decisão chega aqui com seu rol, data, tribunal e turma, o tribunal de onde veio o processo, a carátula, as matérias, o tipo de recurso, o resultado, os juízes que decidiram e assinaram, o relator do voto, os descritores do tribunal, as normas que cita, o RUC quando registrado, e seu texto completo. Quando o tribunal anonimiza uma decisão (a maioria das de família, uma parte do resto) o texto é o anonimizado, e a Croma guarda uma cópia do PDF anonimizado que o tribunal publica. Os nomes nas decisões que o tribunal não anonimiza aparecem como o tribunal os mostra.

Cada coleção tem um endpoint de busca e um de decisão. Busque primeiro e depois leia uma decisão 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 em a Corte Suprema

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

Uma única busca sobre todas as decisões de a Corte Suprema que o Poder Judicial publica, filtrada por turma, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `chamber` | string | Turma opcional, como `chamber` a nomeia num resultado, p. ex. `SEGUNDA, PENAL`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/supreme-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "propiedad industrial", "from_date": "2026-09-01" }'
```

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 de a Corte Suprema à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

## Uma decisão de a Corte Suprema, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/supreme-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "8283326" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, retorna `found: false` com HTTP 200, não um erro.

## Buscar em as Cortes de Apelaciones

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

Uma única busca sobre todas as decisões de as Cortes de Apelaciones que o Poder Judicial publica, filtrada por tribunal, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `court` | string | Corte de Apelaciones opcional, p. ex. `Valdivia` ou `C.A. de Valdivia`. |
| `chamber` | string | Turma opcional, como `chamber` a nomeia num resultado, p. ex. `SEGUNDA, PENAL`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/appeals-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "court": "Valdivia", "from_date": "2026-09-01" }'
```

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 de as Cortes de Apelaciones à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

## Uma decisão de as Cortes de Apelaciones, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/appeals-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "62274427" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, retorna `found: false` com HTTP 200, não um erro.

## Buscar em os juízos cíveis do Chile

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

Uma única busca sobre todas as decisões de os juízos cíveis do Chile que o Poder Judicial publica, filtrada por tribunal, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `court` | string | Tribunal opcional, pelo nome exato como `court` o traz num resultado, p. ex. `27º Juzgado Civil de Santiago`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/civil-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "arrendamiento", "year": 2025 }'
```

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 de os juízos cíveis do Chile à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

> [!NOTE]
>
> Os tribunais de primeira instância publicam aqui suas decisões meses, às vezes anos, depois de proferi-las, e em lotes. A Croma compara todo dia a contagem do tribunal para cada mês com a sua e volta a ler os meses que mudaram, então uma decisão do ano passado pode aparecer hoje.

## Uma decisão de os juízos cíveis do Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/civil-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "201410080" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, retorna `found: false` com HTTP 200, não um erro.

## Buscar em os tribunais penais do Chile

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

Uma única busca sobre todas as decisões de os tribunais penais do Chile que o Poder Judicial publica, filtrada por tribunal, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `court` | string | Tribunal opcional, pelo nome exato como `court` o traz num resultado, p. ex. `27º Juzgado Civil de Santiago`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/criminal-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "receptación", "year": 2025 }'
```

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 de os tribunais penais do Chile à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

> [!NOTE]
>
> Os tribunais de primeira instância publicam aqui suas decisões meses, às vezes anos, depois de proferi-las, e em lotes. A Croma compara todo dia a contagem do tribunal para cada mês com a sua e volta a ler os meses que mudaram, então uma decisão do ano passado pode aparecer hoje.

## Uma decisão de os tribunais penais do Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/criminal-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "141941478" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, retorna `found: false` com HTTP 200, não um erro.

## Buscar em os juízos de família do Chile

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

Uma única busca sobre todas as decisões de os juízos de família do Chile que o Poder Judicial publica, filtrada por tribunal, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `court` | string | Tribunal opcional, pelo nome exato como `court` o traz num resultado, p. ex. `27º Juzgado Civil de Santiago`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/family-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "divorcio", "year": 2024 }'
```

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 de os juízos de família do Chile à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

> [!NOTE]
>
> Os tribunais de primeira instância publicam aqui suas decisões meses, às vezes anos, depois de proferi-las, e em lotes. A Croma compara todo dia a contagem do tribunal para cada mês com a sua e volta a ler os meses que mudaram, então uma decisão do ano passado pode aparecer hoje.

## Uma decisão de os juízos de família do Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/family-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "222163881" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, retorna `found: false` com HTTP 200, não um erro.

## Buscar em os juízos do trabalho do Chile

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

Uma única busca sobre todas as decisões de os juízos do trabalho do Chile que o Poder Judicial publica, filtrada por tribunal, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `court` | string | Tribunal opcional, pelo nome exato como `court` o traz num resultado, p. ex. `27º Juzgado Civil de Santiago`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/labor-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "despido injustificado", "year": 2025 }'
```

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 de os juízos do trabalho do Chile à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

> [!NOTE]
>
> Os tribunais de primeira instância publicam aqui suas decisões meses, às vezes anos, depois de proferi-las, e em lotes. A Croma compara todo dia a contagem do tribunal para cada mês com a sua e volta a ler os meses que mudaram, então uma decisão do ano passado pode aparecer hoje.

## Uma decisão de os juízos do trabalho do Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/labor-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "21936194" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, retorna `found: false` com HTTP 200, não um erro.

## Buscar em os juízos de cobrança trabalhista e previdenciária do Chile

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

Uma única busca sobre todas as decisões de os juízos de cobrança trabalhista e previdenciária do Chile que o Poder Judicial publica, filtrada por tribunal, rol, ano, matéria ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rol, na carátula, nas matérias, nos descritores e no texto completo, p. ex. `prescripción adquisitiva`. Todas as palavras devem aparecer. |
| `case_number` | string | Rol opcional com seu ano, p. ex. `13194-2026`, ou com sua letra num tribunal de primeira instância, p. ex. `C-4513-2026`. |
| `year` | integer | Ano do rol opcional. 0 busca em todos os anos. Por padrão `0`. |
| `matter` | string | Matéria opcional, exatamente como aparece em `matters` de um resultado. |
| `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`. |
| `court` | string | Tribunal opcional, pelo nome exato como `court` o traz num resultado, p. ex. `27º Juzgado Civil de Santiago`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/pjud/labor-collection-court-rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "cotizaciones", "year": 2025 }'
```

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 de os juízos de cobrança trabalhista e previdenciária do Chile à mais antiga. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

> [!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 da decisão.

> [!NOTE]
>
> O Poder Judicial permite baixar um arquivo por decisão: o PDF anonimizado de uma decisão anonimizada. A Croma guarda uma cópia idêntica byte a byte de cada um (`document_url`, `document_status: kept`). Para as demais decisões o tribunal não permite baixar o arquivo, então `document_status` é `not_downloadable` e a decisão completa é o seu `text`.

> [!NOTE]
>
> Os tribunais de primeira instância publicam aqui suas decisões meses, às vezes anos, depois de proferi-las, e em lotes. A Croma compara todo dia a contagem do tribunal para cada mês com a sua e volta a ler os meses que mudaram, então uma decisão do ano passado pode aparecer hoje.

## Uma decisão de os juízos de cobrança trabalhista e previdenciária do Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `8283326`. |
| `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/cl/pjud/labor-collection-court-ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "75417002" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente da decisão) e `document_id`, `case_number` (o rol, p. ex. `19865-2023` ou `C-4513-2026`) e `case_year`, `ruling_date`, `court`, `court_code` e `chamber` (a turma), `lower_court` e `lower_court_case_number` (de onde veio o processo), `case_title` (a carátula), `matters`, `book`, `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (o relator do voto), `rapporteur`, `descriptors`, `cited_norms`, `case_code` (o RUC), `jurisdiction`, `publication_condition`, `anonymized` e `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` e `document_status`. Os campos que o tribunal não informa, ou reserva numa decisão anonimizada, vêm como null.

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

> [!NOTE]
>
> Um id que o tribunal não publica, ou de outra coleção, 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.