SCJN

Mexican Supreme Court case law from the Semanario Judicial de la Federación: every tesis and jurisprudencia published since 1911, over 300k, each in full. Search by words in the title and text and filter by binding force, subject, época, year, deciding level, court or chamber, how the criterion was formed, publication window, or what the court changed since a date. Then read one tesis by its registro digital.

Search tesis

POST /mx/scjn/tesis-search/v1 Dataset Answered over the whole corpus: filters the court’s own search does not offer, the full text in every result, and no dependence on the source at request time.

Field	Type	Notes
`query`	string	Optional words to match in the title and text of the tesis; every word must appear. Leave it empty to filter only.
`tesis_type`	enum	Binding force: `jurisprudencia` (binding), `aislada` (non-binding), or `any`. Default `any`.
`subject`	string	Optional materia filter (e.g. `Civil`, `Constitucional`); a tesis matches when any of its subjects does.
`epoch`	string	Optional época number (`5` through `12`).
`year`	string	Optional 4-digit year of the Semanario issue.
`instance`	string	Optional deciding level, exactly as `instance` reads in results (e.g. `Suprema Corte de Justicia de la Nación`, `Tribunales Colegiados de Circuito`, `Plenos Regionales`).
`court`	string	Optional court or chamber, exactly as `court` reads in results (e.g. `Primera Sala`, `Pleno`).
`formation`	string	Optional way the criterion was formed, exactly as `formation` reads in results (e.g. `Reiteración`).
`published_from`	string	Optional earliest publication date, `yyyy-mm-dd`. Pre-Gaceta tesis carry no publication date and never match a window.
`published_to`	string	Optional latest publication date, `yyyy-mm-dd`.
`updated_after`	string	Optional: only tesis the court modified on or after this date, `yyyy-mm-dd`.
`page`	integer	1-based page number. Default `1`.
`per_page`	integer	Results per page (1-50). Every result carries the full text. Default `20`.

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 as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[]: full tesis records, the same shape the lookup below answers with, newest first (dated tesis by publication_date, then the pre-Gaceta ones by the year of their Semanario issue). With query, every word must appear in the title or the text.

Field	Notes
`registration_number`	Registro digital: the court’s stable id for the tesis, and the key of the lookup.
`title`, `subtitle`	Rubro (the heading that states the criterion) and subtítulo.
`type`	`jurisprudencia` or `aislada`; null when the source reports neither.
`citation`	Official citation key, e.g. `1a./J. 132/2012 (10a.)`.
`epoch`, `epoch_number`	Judicial epoch, by name and number (5 through 12).
`instance`, `circuit`, `court`	Deciding level, judicial circuit (null for SCJN chambers), and the specific chamber or court.
`source`, `subjects`	Publication and materias.
`location`	Citation coordinates in the Semanario: `book`, `volume`, `page`, `month`, `year`.
`text`	The full text of the tesis.
`facts`, `legal_criteria`, `justification`	The sections of tesis published in the structured format (Undécima Época onward); null before it.
`formation`	How the criterion was formed, e.g. `Reiteración`, `Contradicción de criterios (antes contradicción de tesis)`.
`issue`, `publication_date`, `binding_date`	The Semanario issue (e.g. `Libro 28, Agosto de 2023`), the date it was published and the date it became binding; null on pre-Gaceta tesis.
`updated_at`	When the court last modified the record; null on tesis it has not touched since it began recording changes.
`notes`, `precedent_notes`	Publication notes and the precedent history, as plain text.
`linked_case_registrations`, `linked_vote_registrations`	Registro digital ids of the rulings the tesis derives from and of the votes linked to it.
`fingerprint`, `official_url`	The integrity hash the court publishes for the document, and its public page.

Answered over the whole corpus, which follows the Semanario’s weekly publication. updated_after matches the court’s own modification stamp, which only tesis it has touched since 2025 carry.

One tesis

POST /mx/scjn/tesis/v1

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

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: the full record, the same shape as one entry of the search’s results[].

Field	Notes
`registration_number`	Registro digital: the court’s stable id for the tesis, and the key of the lookup.
`title`, `subtitle`	Rubro (the heading that states the criterion) and subtítulo.
`type`	`jurisprudencia` or `aislada`; null when the source reports neither.
`citation`	Official citation key, e.g. `1a./J. 132/2012 (10a.)`.
`epoch`, `epoch_number`	Judicial epoch, by name and number (5 through 12).
`instance`, `circuit`, `court`	Deciding level, judicial circuit (null for SCJN chambers), and the specific chamber or court.
`source`, `subjects`	Publication and materias.
`location`	Citation coordinates in the Semanario: `book`, `volume`, `page`, `month`, `year`.
`text`	The full text of the tesis.
`facts`, `legal_criteria`, `justification`	The sections of tesis published in the structured format (Undécima Época onward); null before it.
`formation`	How the criterion was formed, e.g. `Reiteración`, `Contradicción de criterios (antes contradicción de tesis)`.
`issue`, `publication_date`, `binding_date`	The Semanario issue (e.g. `Libro 28, Agosto de 2023`), the date it was published and the date it became binding; null on pre-Gaceta tesis.
`updated_at`	When the court last modified the record; null on tesis it has not touched since it began recording changes.
`notes`, `precedent_notes`	Publication notes and the precedent history, as plain text.
`linked_case_registrations`, `linked_vote_registrations`	Registro digital ids of the rulings the tesis derives from and of the votes linked to it.
`fingerprint`, `official_url`	The integrity hash the court publishes for the document, and its public page.

Browse tesis

This endpoint is deprecated since 2026-09-07 and stops answering on 2026-12-15. Use its successor, POST /mx/scjn/tesis-search/v1, instead.

POST /mx/scjn/tesis-browse/v1 Dataset

Field	Type	Notes
`query`	string	Optional words to match in the title and text of the tesis; every word must appear. Leave it empty to filter only.
`tesis_type`	enum	Binding force: `jurisprudencia` (binding), `aislada` (non-binding), or `any`. Default `any`.
`subject`	string	Optional materia filter (e.g. `Civil`, `Constitucional`); a tesis matches when any of its subjects does.
`epoch`	string	Optional época number (`5` through `12`).
`year`	string	Optional 4-digit year of the Semanario issue.
`instance`	string	Optional deciding level, exactly as `instance` reads in results (e.g. `Suprema Corte de Justicia de la Nación`, `Tribunales Colegiados de Circuito`, `Plenos Regionales`).
`court`	string	Optional court or chamber, exactly as `court` reads in results (e.g. `Primera Sala`, `Pleno`).
`formation`	string	Optional way the criterion was formed, exactly as `formation` reads in results (e.g. `Reiteración`).
`published_from`	string	Optional earliest publication date, `yyyy-mm-dd`. Pre-Gaceta tesis carry no publication date and never match a window.
`published_to`	string	Optional latest publication date, `yyyy-mm-dd`.
`updated_after`	string	Optional: only tesis the court modified on or after this date, `yyyy-mm-dd`.
`page`	integer	1-based page number. Default `1`.
`per_page`	integer	Results per page (1-20). Every result carries the full text. Default `10`.

curl https://api.croma.run/mx/scjn/tesis-browse/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "subject": "Civil",
        "tesis_type": "jurisprudencia",
        "published_from": "2026-01-01"
      }'

Same response as the search above: as_of, the applied filters, the totals and results[] of full tesis records, newest first. Change the path to migrate; the request is the same, and the search accepts up to 50 results per page.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Monitors

Countries

Search tesis

One tesis

Browse tesis

Full reference

​Search tesis

​One tesis

​Browse tesis

Full reference

Search tesis

One tesis

Browse tesis