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

> La jurisprudencia de los tribunales de Chile: busca en unos 4,65 millones de sentencias de la Corte Suprema, las Cortes de Apelaciones y los tribunales civiles, penales, de familia, laborales y de cobranza, y lee cualquiera completa.

El Poder Judicial de Chile publica las sentencias de sus tribunales: unas 4,65 millones que cualquiera puede leer, en siete colecciones. La Corte Suprema (unas 310.000 desde 2005) y las 17 Cortes de Apelaciones (unos 2 millones desde 2000) publican en un día. Siguen cinco jurisdicciones de primera instancia: civil (unas 856.000), penal (unas 840.000), familia (unas 373.000), laboral (unas 236.000) y cobranza laboral y previsional (unas 26.000), que publican meses o años después de fallar, por lotes.

Cada sentencia llega aquí con su rol, fecha, tribunal y sala, el tribunal de donde viene la causa, la carátula, las materias, el tipo de recurso, el resultado, los jueces que fallaron y firmaron, el redactor, los descriptores del tribunal, las normas que cita, el RUC cuando se registra, y su texto completo. Cuando el tribunal anonimiza una sentencia (la mayoría de las de familia, una parte del resto) el texto es el anonimizado, y Croma guarda una copia del PDF anonimizado que publica el tribunal. Los nombres en las sentencias que el tribunal no anonimiza se muestran como los muestra el tribunal.

Cada colección tiene un endpoint de búsqueda y uno de sentencia. Busca primero y luego lee una sentencia completa.

> [!NOTE]
>
> La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](https://docs.usecroma.com/es/datasets.md).

## Buscar en la Corte Suprema

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

Una sola búsqueda sobre todas las sentencias de la Corte Suprema que publica el Poder Judicial, filtrada por sala, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `chamber` | string | Sala opcional, como la nombra `chamber` en un resultado, p. ej. `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" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de la Corte Suprema a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

## Una sentencia de la Corte Suprema, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

## Buscar en las Cortes de Apelaciones

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

Una sola búsqueda sobre todas las sentencias de las Cortes de Apelaciones que publica el Poder Judicial, filtrada por tribunal, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `court` | string | Corte de Apelaciones opcional, p. ej. `Valdivia` o `C.A. de Valdivia`. |
| `chamber` | string | Sala opcional, como la nombra `chamber` en un resultado, p. ej. `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" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de las Cortes de Apelaciones a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

## Una sentencia de las Cortes de Apelaciones, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

## Buscar en los juzgados civiles de Chile

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

Una sola búsqueda sobre todas las sentencias de los juzgados civiles de Chile que publica el Poder Judicial, filtrada por tribunal, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `court` | string | Tribunal opcional, por su nombre exacto como lo da `court` en un resultado, p. ej. `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 }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de los juzgados civiles de Chile a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

> [!NOTE]
>
> Los tribunales de primera instancia publican aquí sus sentencias meses, a veces años, después de dictarlas, y por lotes. Croma compara cada día el conteo del tribunal para cada mes con el suyo y vuelve a leer los meses que cambiaron, así que una sentencia del año pasado puede aparecer hoy.

## Una sentencia de los juzgados civiles de Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

## Buscar en los tribunales penales de Chile

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

Una sola búsqueda sobre todas las sentencias de los tribunales penales de Chile que publica el Poder Judicial, filtrada por tribunal, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `court` | string | Tribunal opcional, por su nombre exacto como lo da `court` en un resultado, p. ej. `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 }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de los tribunales penales de Chile a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

> [!NOTE]
>
> Los tribunales de primera instancia publican aquí sus sentencias meses, a veces años, después de dictarlas, y por lotes. Croma compara cada día el conteo del tribunal para cada mes con el suyo y vuelve a leer los meses que cambiaron, así que una sentencia del año pasado puede aparecer hoy.

## Una sentencia de los tribunales penales de Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

## Buscar en los juzgados de familia de Chile

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

Una sola búsqueda sobre todas las sentencias de los juzgados de familia de Chile que publica el Poder Judicial, filtrada por tribunal, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `court` | string | Tribunal opcional, por su nombre exacto como lo da `court` en un resultado, p. ej. `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 }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de los juzgados de familia de Chile a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

> [!NOTE]
>
> Los tribunales de primera instancia publican aquí sus sentencias meses, a veces años, después de dictarlas, y por lotes. Croma compara cada día el conteo del tribunal para cada mes con el suyo y vuelve a leer los meses que cambiaron, así que una sentencia del año pasado puede aparecer hoy.

## Una sentencia de los juzgados de familia de Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

## Buscar en los juzgados del trabajo de Chile

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

Una sola búsqueda sobre todas las sentencias de los juzgados del trabajo de Chile que publica el Poder Judicial, filtrada por tribunal, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `court` | string | Tribunal opcional, por su nombre exacto como lo da `court` en un resultado, p. ej. `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 }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de los juzgados del trabajo de Chile a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

> [!NOTE]
>
> Los tribunales de primera instancia publican aquí sus sentencias meses, a veces años, después de dictarlas, y por lotes. Croma compara cada día el conteo del tribunal para cada mes con el suyo y vuelve a leer los meses que cambiaron, así que una sentencia del año pasado puede aparecer hoy.

## Una sentencia de los juzgados del trabajo de Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

## Buscar en los juzgados de cobranza laboral y previsional de Chile

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

Una sola búsqueda sobre todas las sentencias de los juzgados de cobranza laboral y previsional de Chile que publica el Poder Judicial, filtrada por tribunal, rol, año, materia o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rol, la carátula, las materias, los descriptores y el texto completo, p. ej. `prescripción adquisitiva`. Todas las palabras deben aparecer. |
| `case_number` | string | Rol opcional con su año, p. ej. `13194-2026`, o con su letra en un tribunal de primera instancia, p. ej. `C-4513-2026`. |
| `year` | integer | Año del rol opcional. 0 busca en todos los años. Por defecto `0`. |
| `matter` | string | Materia opcional, tal como aparece en `matters` de un resultado. |
| `from_date` | string | Opcional: solo sentencias dictadas en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias dictadas en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
| `court` | string | Tribunal opcional, por su nombre exacto como lo da `court` en un resultado, p. ej. `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 }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente de los juzgados de cobranza laboral y previsional de Chile a la más antigua. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra la sentencia; para leer el texto usa el endpoint de la sentencia.

> [!NOTE]
>
> El Poder Judicial permite descargar un archivo por sentencia: el PDF anonimizado de una sentencia anonimizada. Croma guarda una copia idéntica byte a byte de cada uno (`document_url`, `document_status: kept`). Para las demás sentencias el tribunal no permite descargar su archivo, así que `document_status` es `not_downloadable` y la sentencia completa es su `text`.

> [!NOTE]
>
> Los tribunales de primera instancia publican aquí sus sentencias meses, a veces años, después de dictarlas, y por lotes. Croma compara cada día el conteo del tribunal para cada mes con el suyo y vuelve a leer los meses que cambiaron, así que una sentencia del año pasado puede aparecer hoy.

## Una sentencia de los juzgados de cobranza laboral y previsional de Chile, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `8283326`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el id permanente de la sentencia) y `document_id`, `case_number` (el rol, p. ej. `19865-2023` o `C-4513-2026`) y `case_year`, `ruling_date`, `court`, `court_code` y `chamber` (la sala), `lower_court` y `lower_court_case_number` (de dónde viene la causa), `case_title` (la carátula), `matters`, `book` (el libro), `appeal_type`, `outcome`, `decision`, `procedural_status`, `judges`, `signatories`, `drafting_judge` (el redactor), `rapporteur` (el relator), `descriptors`, `cited_norms`, `case_code` (el RUC), `jurisdiction`, `publication_condition`, `anonymized` y `anonymization_status`, `page_count`, `original_format`, `citation`, `excerpt`, `document_url`, `source_document_url` y `document_status`. Los campos que el tribunal no indica, o que reserva en una sentencia anonimizada, vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el tribunal no publica, o uno de la colección de otro tribunal, devuelve `found: false` con HTTP 200, no un error.

> **[Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)**
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


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