> ## 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 (裁判例)

> La jurisprudencia de los tribunales de Japón: busca en unas 68.000 sentencias de la Corte Suprema y los tribunales superiores e inferiores desde 1947, y lee cualquiera completa con su documento original.

La Corte Suprema de Japón publica la jurisprudencia que los tribunales seleccionan para sus repertorios: las sentencias y decisiones de la propia Corte Suprema, los repertorios de los tribunales superiores, el boletín de los tribunales inferiores y las colecciones de casos contencioso administrativos, laborales y de propiedad intelectual, unas 68.000 sentencias desde 1947. Cada una llega aquí con su número y nombre de caso, el tribunal y la sala, la fecha, el tipo de decisión y su resultado, la decisión del tribunal inferior, el resumen del propio tribunal y las normas que cita cuando el tribunal los publica, el texto completo leído del documento del tribunal, el documento tal como lo publicó el tribunal y un enlace a su página en los tribunales.

Busca en todas las colecciones a la vez, por colección, tribunal, número de caso, año o fecha, o con texto libre en japonés que llega hasta los resúmenes y el cuerpo de cada sentencia.

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

## Buscar sentencias

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

Una sola búsqueda sobre todas las colecciones de jurisprudencia de los tribunales desde 1947, filtrada por colección, tribunal, número de caso, año o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales en japonés, que se buscan en el nombre del caso, el resumen del tribunal, las normas citadas y el texto, p. ej. `解雇権濫用` o `過払金 返還`. Dos o más caracteres; todas las palabras deben aparecer. |
| `collection` | enum | Colección opcional: `supreme`, `high`, `lower`, `administrative`, `labor`, `ip` o `ip_high`. |
| `court` | string | Tribunal opcional como lo nombra `court`, p. ej. `最高裁判所第一小法廷`, `東京高等裁判所`, `大阪地方裁判所`, comparado desde el inicio: `最高裁判所` encuentra todas las salas. |
| `case_number` | string | Número de caso opcional como lo imprime el tribunal, p. ej. `平成21(オ)257`. No importan los espacios ni el ancho de los caracteres. |
| `year` | integer | Año de la sentencia opcional. 0 busca en todos los años. Por defecto `0`. |
| `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`. |

```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" }'
```

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 a la más antigua. Cada resultado incluye `id` (el número permanente de la sentencia en el sitio de los tribunales, p. ej. `93117`), `collections` (`supreme`, `high`, `lower`, `administrative`, `labor`, `ip`, `ip_high`; una sentencia puede estar en varias), `case_number` (p. ej. `平成21(オ)257`) y `case_year`, `title` (el nombre del caso), `ruling_date` y `ruling_date_japanese`, `year`, `court` (con la sala para la Corte Suprema), `branch`, `department`, `judgment_type` (判決, 決定), `result` (棄却, 破棄差戻...), `reporter` (la cita en los repertorios oficiales), la decisión del tribunal inferior (`lower_court`, `lower_case_number`, `lower_ruling_date`, `lower_result`), el resumen del propio tribunal cuando lo publica (`holding` para 判示事項, `gist` para 裁判要旨, `statutes` para 参照法条), `field`, los campos de propiedad intelectual (`right_type`, `suit_type`, `ip_case_kind`, `invention`, `issues`, `appeal`, `appeal_result`, `ip_result`), `text_status` (`ok`, `scanned` o `missing`), `official_url` (la página de la sentencia en los tribunales), `document_url` (la copia de Croma del documento del tribunal, idéntica byte a byte) y `source_document_url` (el enlace propio del documento en los tribunales). Los campos que el tribunal no indica vienen en null; los nombres de las partes nunca son campos.

<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 Courts of Japan Ruling.
</Note>

## Una sentencia, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `ruling_id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, p. ej. `93117`, o su `official_url`. |
| `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/jp/courts-jp/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "93117" }'
```

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 de la sentencia, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el número permanente de la sentencia en el sitio de los tribunales, p. ej. `93117`), `collections` (`supreme`, `high`, `lower`, `administrative`, `labor`, `ip`, `ip_high`; una sentencia puede estar en varias), `case_number` (p. ej. `平成21(オ)257`) y `case_year`, `title` (el nombre del caso), `ruling_date` y `ruling_date_japanese`, `year`, `court` (con la sala para la Corte Suprema), `branch`, `department`, `judgment_type` (判決, 決定), `result` (棄却, 破棄差戻...), `reporter` (la cita en los repertorios oficiales), la decisión del tribunal inferior (`lower_court`, `lower_case_number`, `lower_ruling_date`, `lower_result`), el resumen del propio tribunal cuando lo publica (`holding` para 判示事項, `gist` para 裁判要旨, `statutes` para 参照法条), `field`, los campos de propiedad intelectual (`right_type`, `suit_type`, `ip_case_kind`, `invention`, `issues`, `appeal`, `appeal_result`, `ip_result`), `text_status` (`ok`, `scanned` o `missing`), `official_url` (la página de la sentencia en los tribunales), `document_url` (la copia de Croma del documento del tribunal, idéntica byte a byte) y `source_document_url` (el enlace propio del documento en los tribunales). Los campos que el tribunal no indica vienen en null; los nombres de las partes nunca son campos.

<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. `content` es null cuando `text_status` no es `ok`; `document_url` sigue entregando el documento del tribunal.
</Note>

<Note>
  Un `id` que los tribunales no han publicado devuelve `found: false` con HTTP 200, no un error.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


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