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

> Busque jurisprudencia e tesis aisladas da Suprema Corte no Semanario Judicial e leia qualquer tesis completa.

Jurisprudencia da Suprema Corte de Justicia de la Nación a partir do Semanario
Judicial de la Federación: 300k+ tesis, com busca por texto e filtros por
obrigatoriedade, matéria, época e ano. Busque primeiro e depois leia uma tesis
completa pelo seu registro digital.

## Buscar tesis

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

| Campo        | Tipo    | Notas                                                                                  |
| ------------ | ------- | -------------------------------------------------------------------------------------- |
| `query`      | string  | **Obrigatório.** Termos de busca.                                                      |
| `tesis_type` | string  | Obrigatoriedade: `jurisprudencia` (obrigatória), `aislada` (não obrigatória) ou `any`. |
| `subject`    | string  | Filtro opcional por matéria (p. ex. `Civil`, `Constitucional`).                        |
| `epoch`      | string  | Número de época, opcional (`5` a `12`).                                                |
| `year`       | string  | Ano de 4 dígitos, opcional.                                                            |
| `page`       | integer | Número da 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" }'
```

Retorna `query`, `total`, `total_pages`, `page`, `per_page`, `count`,
`results` e `facets`: os valores válidos (com contagens) para cada filtro,
calculados sobre a busca atual. Use essas strings exatas ao filtrar.

| Campo                        | Notas                                                                                     |
| ---------------------------- | ----------------------------------------------------------------------------------------- |
| `registration_number`        | Registro digital. Use-o na consulta abaixo.                                               |
| `title`                      | Rubro da tesis.                                                                           |
| `type`                       | `jurisprudencia` ou `aislada`; null quando a fonte não reporta nenhum.                    |
| `citation`                   | Chave oficial, p. ex. `1a./J. 132/2012 (10a.)`.                                           |
| `epoch`, `instance`, `court` | Época, instância e sala ou tribunal específico.                                           |
| `source`, `subjects`, `year` | Fonte, matérias e ano.                                                                    |
| `location`                   | Localização: `book`, `volume`, `page`, `month`, `year`.                                   |
| `snippets`                   | Trechos correspondentes destacados, com marcação `<em>` inline sobre as correspondências. |

## Uma tesis

`POST /mx/scjn/tesis/v1`

| Campo                 | Tipo   | Notas                                                      |
| --------------------- | ------ | ---------------------------------------------------------- |
| `registration_number` | string | **Obrigatório.** Registro digital dos resultados de busca. |

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

Retorna `found`, `registration_number` e `tesis`. Além dos campos de busca,
o registro completo agrega `subtitle`, `circuit`, `text` (o texto completo da
tesis), `notes`, `precedent_notes`, `formation` (como o critério se formou,
p. ex. `Contradicción de criterios`), `issue` (o livro do Semanario, p. ex.
`Libro 28, Agosto de 2023`), `publication_date` e `binding_date` (null em
tesis anteriores à Gaceta), `linked_case_registrations`,
`linked_vote_registrations`, `fingerprint` (o hash de integridade que a Corte
publica para o documento) e `official_url`.

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>