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

# Sentencias del CJF

> Búsqueda de texto completo sobre las versiones públicas de las sentencias de los órganos federales de México, y el registro completo de una sentencia por su NEUN.

El poder judicial federal de México publica las versiones públicas de sus
sentencias. Búscalas por texto completo, con cuatro modos de coincidencia
(frase exacta, al menos una palabra, excepto una palabra, o un rango de
palabras) y límites de fecha opcionales, y obtén el registro de una sentencia
por su NEUN: órgano que resuelve, materia, tema y síntesis, y el registro
sección por sección.

## Buscar sentencias

`POST /mx/cjf-sentencias/search/v1` [Live](https://docs.usecroma.com/es/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | **Obligatorio.** Palabras o una frase a buscar en el texto y los resúmenes de las sentencias. |
| `match_mode` | enum | Cómo coincidir: `exact_phrase`, `any_word`, `except_word` o `word_range`. Por defecto `exact_phrase`. |
| `word_range` | integer | Para `word_range`: a cuántas palabras de distancia pueden estar los términos (1-100). Por defecto `1`. |
| `from_date` | string | Solo sentencias en o después de esta fecha (yyyy-mm-dd). |
| `to_date` | string | Solo sentencias en o antes de esta fecha (yyyy-mm-dd). |
| `page` | integer | Número de página (base 1). Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/mx/cjf-sentencias/search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "amparo" }'
```

Devuelve `query`, `match_mode`, los límites de fecha aplicados, `results` y `pagination` (`total`, `page`, `page_size`, `total_pages`).

| Campo | Notas |
| - | - |
| `neun` | El id de la sentencia. Pásalo a `cjf-sentencia` para el registro completo. |
| `case_number` | Número de expediente. |
| `court`, `court_type`, `circuit`, `specialty` | El órgano que resuelve y dónde se ubica. |
| `subject_matter`, `case_type` | Materia y tipo de asunto. |
| `ruling_date` | Fecha de la sentencia tal como se publica (sin modificar). |
| `topic`, `summary` | Tema y síntesis de la sentencia. |
| `has_document` | Si hay una versión pública en archivo. |

## Detalle de la sentencia

`POST /mx/cjf-sentencias/sentencia/v1` [Live](https://docs.usecroma.com/es/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `neun` | string | **Obligatorio.** El `neun` de la búsqueda anterior. |

```bash theme={"dark"}
curl https://api.croma.run/mx/cjf-sentencias/sentencia/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "neun": "11675036" }'
```

Devuelve `found`, `neun` y `sentencia` (null cuando el NEUN es desconocido).

| Campo | Notas |
| - | - |
| `case_number` | Número de expediente. |
| `internal_number` | Número OCC, el control interno del órgano. |
| `court`, `case_type` | Órgano que resuelve y tipo de asunto. |
| `sections` | El registro de la sentencia sección por sección; cada sección es una lista de filas etiqueta/valor tal como las presenta la fuente. |

> [!NOTE]
>
> Son versiones públicas de las sentencias de los órganos federales de México:
> los datos personales los suprime el publicador antes de su difusión.

> [!NOTE]
>
> Estas consultas pueden tardar más que una petición típica. Son
> [trabajos asíncronos](https://docs.usecroma.com/es/async-jobs.md). Por defecto la petición espera en
> línea y devuelve `{ data }`, o puedes hacer polling o usar un `callback_url`.

> [card] [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.