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

# SCJN

> Busca jurisprudencia y tesis aisladas de la Suprema Corte en el Semanario Judicial, y lee cualquier tesis completa.

Jurisprudencia de la Suprema Corte de Justicia de la Nación desde el Semanario
Judicial de la Federación: 300k+ tesis, con búsqueda por texto y filtros por
obligatoriedad, materia, época y año. Busca primero y luego lee una tesis
completa por su registro digital.

## Buscar tesis

`POST /mx/scjn/tesis-search/v1`

| Campo        | Tipo    | Notas                                                                               |
| ------------ | ------- | ----------------------------------------------------------------------------------- |
| `query`      | string  | **Obligatorio.** Términos de búsqueda.                                              |
| `tesis_type` | string  | Obligatoriedad: `jurisprudencia` (obligatoria), `aislada` (no obligatoria) o `any`. |
| `subject`    | string  | Filtro opcional por materia (p. ej. `Civil`, `Constitucional`).                     |
| `epoch`      | string  | Número de época, opcional (`5` a `12`).                                             |
| `year`       | string  | Año de 4 dígitos, opcional.                                                         |
| `page`       | integer | Número de página (base 1).                                                          |
| `per_page`   | integer | Resultados por página.                                                              |

```bash theme={"dark"}
curl https://api.croma.run/mx/scjn/tesis-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "interés usurario", "tesis_type": "jurisprudencia" }'
```

Devuelve `query`, `total`, `total_pages`, `page`, `per_page`, `count`,
`results` y `facets`: los valores válidos (con conteos) para cada filtro,
calculados sobre la búsqueda actual. Usa esas cadenas exactas al filtrar.

| Campo                        | Notas                                                                                    |
| ---------------------------- | ---------------------------------------------------------------------------------------- |
| `registration_number`        | Registro digital. Úsalo en la consulta de abajo.                                         |
| `title`                      | Rubro de la tesis.                                                                       |
| `type`                       | `jurisprudencia` o `aislada`; null cuando la fuente no reporta ninguno.                  |
| `citation`                   | Clave oficial, p. ej. `1a./J. 132/2012 (10a.)`.                                          |
| `epoch`, `instance`, `court` | Época, instancia y sala o tribunal específico.                                           |
| `source`, `subjects`, `year` | Fuente, materias y año.                                                                  |
| `location`                   | Localización: `book`, `volume`, `page`, `month`, `year`.                                 |
| `snippets`                   | Fragmentos coincidentes resaltados, con marcado `<em>` en línea sobre las coincidencias. |

## Una tesis

`POST /mx/scjn/tesis/v1`

| Campo                 | Tipo   | Notas                                                            |
| --------------------- | ------ | ---------------------------------------------------------------- |
| `registration_number` | string | **Obligatorio.** Registro digital de los resultados de búsqueda. |

```bash theme={"dark"}
curl https://api.croma.run/mx/scjn/tesis/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "registration_number": "2001360" }'
```

Devuelve `found`, `registration_number` y `tesis`. Además de los campos de
búsqueda, el registro completo agrega `subtitle`, `circuit`, `text` (el texto
completo de la tesis), `notes`, `precedent_notes`, `formation` (cómo se formó el
criterio, p. ej. `Contradicción de criterios`), `issue` (el libro del Semanario,
p. ej. `Libro 28, Agosto de 2023`), `publication_date` y `binding_date` (null en
tesis previas a la Gaceta), `linked_case_registrations`,
`linked_vote_registrations`, `fingerprint` (el hash de integridad que la Corte
publica para el documento) y `official_url`.

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