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

> Search Mexican Supreme Court case law (tesis and jurisprudencia) from the Semanario Judicial, and read any tesis in full.

Mexican Supreme Court case law from the Semanario Judicial de la Federación:
300k+ tesis, searchable by text and filterable by binding force, subject, época,
and year. Search first, then read a tesis in full by its registro digital.

## Search tesis

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

| Field        | Type    | Notes                                                                         |
| ------------ | ------- | ----------------------------------------------------------------------------- |
| `query`      | string  | **Required.** Search terms.                                                   |
| `tesis_type` | string  | Binding force: `jurisprudencia` (binding), `aislada` (non-binding), or `any`. |
| `subject`    | string  | Optional materia filter (e.g. `Civil`, `Constitucional`).                     |
| `epoch`      | string  | Optional época number (`5` through `12`).                                     |
| `year`       | string  | Optional 4-digit year.                                                        |
| `page`       | integer | 1-based page number.                                                          |
| `per_page`   | integer | Results per page.                                                             |

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

Returns `query`, `total`, `total_pages`, `page`, `per_page`, `count`,
`results`, and `facets`: the valid values (with hit counts) for each filter,
computed over the current query. Use those exact strings when filtering.

| Field                        | Notes                                                                   |
| ---------------------------- | ----------------------------------------------------------------------- |
| `registration_number`        | Registro digital. Pass it to the lookup below.                          |
| `title`                      | Tesis heading.                                                          |
| `type`                       | `jurisprudencia` or `aislada`; null when the source reports neither.    |
| `citation`                   | Official citation key, e.g. `1a./J. 132/2012 (10a.)`.                   |
| `epoch`, `instance`, `court` | Judicial epoch, deciding level, and specific chamber or court.          |
| `source`, `subjects`, `year` | Publication, materias, and year.                                        |
| `location`                   | Citation coordinates: `book`, `volume`, `page`, `month`, `year`.        |
| `snippets`                   | Highlighted match fragments, with inline `<em>` markup around the hits. |

## One tesis

`POST /mx/scjn/tesis/v1`

| Field                 | Type   | Notes                                                   |
| --------------------- | ------ | ------------------------------------------------------- |
| `registration_number` | string | **Required.** Registro digital from the search results. |

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

Returns `found`, `registration_number`, and `tesis`. Beyond the search fields,
the full record adds `subtitle`, `circuit`, `text` (the full tesis),
`notes`, `precedent_notes`, `formation` (how the criterion was formed, e.g.
`Contradicción de criterios`), `issue` (the Semanario issue, e.g.
`Libro 28, Agosto de 2023`), `publication_date` and `binding_date` (null on
pre-Gaceta tesis), `linked_case_registrations`, `linked_vote_registrations`,
`fingerprint` (the integrity hash the court publishes for the document), and
`official_url`.

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>