# Croma API

> Build with government data.

## Docs

- [Introduction](https://docs.usecroma.com/introduction.md): Build with government data.
- [Quickstart](https://docs.usecroma.com/quickstart.md): Get a key and make your first Croma API call in three steps.
- [Authentication](https://docs.usecroma.com/authentication.md): How Croma API keys and the bearer scheme work.
- [MCP](https://docs.usecroma.com/mcp-server.md): Call Croma's data sources as tools over MCP, using your API key.
- [Async jobs](https://docs.usecroma.com/async-jobs.md): How long-running lookups work: wait inline, poll, or get a callback.
- [Batch requests](https://docs.usecroma.com/batch.md): Resolve many lookups in one call, with per-item results and partial failure.
- [Rate limits](https://docs.usecroma.com/rate-limits.md): How Croma API quotas are bucketed and reported.
- [Errors](https://docs.usecroma.com/errors.md): The Croma API error envelope and status codes.
- [Rama Judicial](https://docs.usecroma.com/guides/colombia/rama-judicial.md): Search Colombian judicial processes, resolve a case by radicación, and list its actuaciones.
- [SAMAI (Consejo de Estado)](https://docs.usecroma.com/guides/colombia/samai.md): Search live contentious-administrative litigation across the Consejo de Estado and every Tribunal and Juzgado Administrativo.
- [Consejo de Estado](https://docs.usecroma.com/guides/colombia/consejo-estado.md): Search the historical administrative case-law of Colombia's Consejo de Estado, and read any providencia in full.
- [CNDJ](https://docs.usecroma.com/guides/colombia/cndj.md): Search disciplinary rulings against judges and lawyers, and read any ruling in full.
- [Superfinanciera](https://docs.usecroma.com/guides/colombia/superfinanciera.md): Retrieve the action history of a jurisdictional complaint (demanda) from Colombia's Superfinanciera.
- [Registraduría](https://docs.usecroma.com/guides/colombia/registraduria.md): Check whether a Colombian cédula is active or cancelled due to death.
- [Policía Nacional](https://docs.usecroma.com/guides/colombia/policia.md): Check a person's Colombian criminal record (antecedentes) by document.
- [Procuraduría](https://docs.usecroma.com/guides/colombia/procuraduria.md): Check a person or entity's Procuraduría antecedentes (disciplinary, penal, contractual, fiscal, and pérdida de investidura records) by document.
- [Contraloría](https://docs.usecroma.com/guides/colombia/contraloria.md): Check whether a person is reported as a responsable fiscal in the Contraloría's SIBOR boletín, by document.
- [Contaduría](https://docs.usecroma.com/guides/colombia/contaduria.md): Check whether a person or entity is a delinquent debtor to the Colombian State, by document.
- [ADRES (BDUA)](https://docs.usecroma.com/guides/colombia/adres.md): Look up a person's health-system affiliation in Colombia by document.
- [SICAAC](https://docs.usecroma.com/guides/colombia/sicaac.md): Look up Colombian natural-person insolvency cases by document.
- [RUES](https://docs.usecroma.com/guides/colombia/rues.md): Look up Colombian entities in RUES by name or NIT: chamber, status, activities, addresses.
- [Supersociedades](https://docs.usecroma.com/guides/colombia/supersociedades.md): Annual financial statements of a Colombian company by NIT: income statement, balance sheet and cash flow per fiscal year.
- [DIAN](https://docs.usecroma.com/guides/colombia/dian.md): Validate a Colombian electronic document by CUFE and NIT, and search DIAN's published tax doctrine.
- [SECOP](https://docs.usecroma.com/guides/colombia/secop.md): Colombian public procurement (SECOP II): processes, awards, contracts with their additions, guarantees and delivery plan, plus contractor sanctions.
- [ANCP-CCE](https://docs.usecroma.com/guides/colombia/ancp-cce.md): Search doctrinal opinions (conceptos) on Colombian public procurement, and read any concepto in full.
- [RUNT](https://docs.usecroma.com/guides/colombia/runt.md): Resolve a Colombian vehicle in RUNT by plate and the registered owner's document.
- [SIMIT](https://docs.usecroma.com/guides/colombia/simit.md): Look up a SIMIT account status by vehicle plate or identification number.
- [Legalize](https://docs.usecroma.com/guides/colombia/legalize.md): Search Colombian legislation as structured data and resolve a law's full text by id.
- [SIATA](https://docs.usecroma.com/guides/colombia/siata.md): Live weather, rainfall, and air-quality station readings for the Aburrá Valley (Medellín).
- [SUNAT](https://docs.usecroma.com/guides/peru/sunat.md): Look up Peruvian taxpayer (RUC) information by RUC, identity document, or name.
- [RREE](https://docs.usecroma.com/guides/peru/rree.md): Verify Peruvian foreigner identity card data.
- [SAT Lima](https://docs.usecroma.com/guides/peru/sat-lima.md): Look up outstanding debt owed to the SAT de Lima by DNI, RUC, plate, ticket, or code.
- [SAT Lima Capture Orders](https://docs.usecroma.com/guides/peru/sat-lima-capturas.md): Check whether a vehicle plate has an outstanding capture order in Lima.
- [Callao Traffic Tickets](https://docs.usecroma.com/guides/peru/callao-papeletas.md): List a vehicle plate's outstanding traffic tickets in Callao.
- [SUTRAN Infraction Record](https://docs.usecroma.com/guides/peru/sutran-infracciones.md): Look up a vehicle plate's infraction record from SUTRAN.
- [APESEG SOAT Certificate History](https://docs.usecroma.com/guides/peru/apeseg-soat.md): Look up a vehicle plate's SOAT certificate history from APESEG.
- [SBS SOAT Report](https://docs.usecroma.com/guides/peru/sbs-soat.md): Look up a vehicle plate's SOAT accident history and policy list from SBS.
- [DOF](https://docs.usecroma.com/guides/mexico/dof.md): Read Mexico's official federal gazette (Diario Oficial de la Federación) by date, and pull the full text of any publication.
- [Cámara de Diputados](https://docs.usecroma.com/guides/mexico/diputados.md): Mexican federal laws, codes, and reglamentos, with the full reform history behind each one.
- [CNBV](https://docs.usecroma.com/guides/mexico/cnbv.md): The CNBV's banking and securities regulations, including the Circular Única de Bancos and its full modification history.
- [Banxico](https://docs.usecroma.com/guides/mexico/banxico.md): Every circular and disposición issued by Banco de México since 1969, with abrogation status and consolidated text.
- [SCJN](https://docs.usecroma.com/guides/mexico/scjn.md): Search Mexican Supreme Court case law (tesis and jurisprudencia) from the Semanario Judicial, and read any tesis in full.
- [Fiscalías (México)](https://docs.usecroma.com/guides/mexico/fiscalias.md): Public press bulletins from Mexican prosecutors: arrests, charges, and sentences, one endpoint per jurisdiction, searchable by keyword and date.
- [SIEM](https://docs.usecroma.com/guides/mexico/siem.md): Mexico's business establishment directory: search by name and pull each establishment's declared commercial profile.
- [Web Search](https://docs.usecroma.com/guides/global/web-search.md): AI-powered web search with structured, scored results.
- [Extract](https://docs.usecroma.com/guides/global/extract.md): Turn any public web page into clean Markdown, or into a typed object you describe with a JSON Schema.
- [Generate](https://docs.usecroma.com/guides/global/generate.md): Read a public web page and return a new object built from it, following your instructions and your JSON Schema.
- [Research](https://docs.usecroma.com/guides/global/research.md): Answer an open question from live sources and return a cited report in Markdown.
- [API Reference](https://docs.usecroma.com/api-reference/overview.md): Every Croma endpoint, with an interactive playground.
- [Rama Judicial Cases by Entity](https://docs.usecroma.com/api-reference/colombia/rama-judicial-cases-by-entity.md): Search Colombian judicial cases by entity name. Optional filters narrow by entity type, court code, recent activity, and page.
- [Rama Judicial Cases by Radicado](https://docs.usecroma.com/api-reference/colombia/rama-judicial-cases-by-radicado.md): Resolve a Colombian judicial case by radicado and return case metadata plus the first 40 actuaciones (actions) available.
- [Rama Judicial Cases by Radicado (Batch)](https://docs.usecroma.com/api-reference/colombia/rama-judicial-cases-by-radicado-batch.md): Resolve up to 50 Colombian judicial cases by radicado in one request. Returns one result per radicado in input order, each with its own status, so a single bad radicado never fails the batch. Each item counts as one request against your quota.
- [Consejo de Estado Processes](https://docs.usecroma.com/api-reference/colombia/consejo-de-estado-processes.md): Search Colombian contentious-administrative processes across the Consejo de Estado and every Tribunal and Juzgado Administrativo. Search by party name, radicado, or process class, scoped to a corporación. Returns process metadata (radicado, corporación, ponente, class, filing date, parties, subject,…
- [Consejo de Estado Corporaciones](https://docs.usecroma.com/api-reference/colombia/consejo-de-estado-corporaciones.md): List every corporación (despacho) in the contentious-administrative jurisdiction, with its code and name. Use a code to scope a `samai-processes` search.
- [Consejo de Estado Secciones](https://docs.usecroma.com/api-reference/colombia/consejo-de-estado-secciones.md): List the secciones (chambers) available inside one corporación.
- [Consejo de Estado Jurisprudence Search](https://docs.usecroma.com/api-reference/colombia/consejo-de-estado-jurisprudence-search.md): Search the historical administrative case-law of Colombia's Consejo de Estado (traditional Relatoría, broadly pre-December-2021). Narrow by section/sala, providencia type (auto, concepto, sentencia), date window, número de proceso (radicado), consejero ponente, demandante, demandado, and norma deman…
- [Consejo de Estado Providencia](https://docs.usecroma.com/api-reference/colombia/consejo-de-estado-providencia.md): Retrieve the full text of a Consejo de Estado providencia from the content permalink (`url`) returned by a search result.
- [CNDJ Rulings Search](https://docs.usecroma.com/api-reference/colombia/cndj-rulings-search.md): Search disciplinary rulings against judges and lawyers from the Relatoría de la CNDJ. Query by free text or by advanced filters (magistrado ponente, tema, disciplinado, asunto, restrictor, año de radicación). Each result carries the numero unico and numero ficha (the record key), magistrado ponente,…
- [CNDJ Ruling](https://docs.usecroma.com/api-reference/colombia/cndj-ruling.md): Retrieve one disciplinary ruling by its record key (numero unico + numero ficha), including the editorial fields (titulación, descriptores, fuentes normativas, salvamentos y aclaraciones), the URL of the full ruling PDF, and the extracted full text when the document carries a text layer.
- [Superfinanciera Complaints](https://docs.usecroma.com/api-reference/colombia/superfinanciera-complaints.md): Return the action history of a specific jurisdictional complaint filed against a person or entity at Colombia's Superfinanciera.
- [Registraduría Vital Status](https://docs.usecroma.com/api-reference/colombia/registraduría-vital-status.md): Check a Colombian cédula's vital status. Returns `found: false` if the cédula isn't in the registry; otherwise `status` is `ALIVE` or `DECEASED`.
- [Policía Criminal Records](https://docs.usecroma.com/api-reference/colombia/policía-criminal-records.md): Check a person's Colombian criminal record (antecedentes). `document_type` defaults to `CC`.
- [Procuraduría Disciplinary Records](https://docs.usecroma.com/api-reference/colombia/procuraduría-disciplinary-records.md): Check a person or entity's Procuraduría antecedentes (disciplinary, penal, contractual, fiscal, and pérdida de investidura records via SIRI). `document_type` defaults to `CC`. `found: false` when the document isn't registered.
- [Contraloría Fiscal Records](https://docs.usecroma.com/api-reference/colombia/contraloría-fiscal-records.md): Check whether a person is reported as a responsable fiscal in the Contraloría's SIBOR boletín (certificado de antecedentes de responsabilidad fiscal). `document_type` defaults to `CC`. Returns the verdict plus a verification code.
- [Contaduría State Delinquent Debtor Records](https://docs.usecroma.com/api-reference/colombia/contaduría-state-delinquent-debtor-records.md): Check whether a person or entity is a delinquent debtor to the Colombian State, from the Contaduría General de la Nación's register (Boletín de Deudores Morosos del Estado). Returns two verdicts: delinquent debt owed to the State (Ley 901 de 2004) and default on a payment agreement (Ley 1066 de 2006…
- [ADRES Health Affiliation Status](https://docs.usecroma.com/api-reference/colombia/adres-health-affiliation-status.md): Look up a person's affiliation to the Colombian health system (BDUA): the entities (EPS) they are or were affiliated to, the régimen (contributivo/subsidiado), affiliation dates, and affiliate type. `document_type` defaults to `CC`. Returns `found: false` when the document is not registered in BDUA.
- [SICAAC Insolvency Cases](https://docs.usecroma.com/api-reference/colombia/sicaac-insolvency-cases.md): Look up Colombian natural-person insolvency cases by document number. `document_type` defaults to `CC` (Cédula de Ciudadanía).
- [RUES Entities by Name](https://docs.usecroma.com/api-reference/colombia/rues-entities-by-name.md): Search Colombian entities in RUES (Registro Único Empresarial y Social) by name. Returns paginated records (10 per page; use `page`), each with its full registry detail.
- [RUES Entity by NIT](https://docs.usecroma.com/api-reference/colombia/rues-entity-by-nit.md): Resolve a Colombian entity by NIT in RUES and return the full registry record (chamber, status, dates, CIIU activities, addresses, contact, indicators) plus financial statements by year, renewal history, legal representatives and related parties, and registry notices. `found: false` when no exact-NI…
- [Supersociedades Financial Statements](https://docs.usecroma.com/api-reference/colombia/supersociedades-financial-statements.md): Annual financial statements a Colombian company has filed with Supersociedades, by NIT: income statement (revenue, gross/operating/net profit), balance sheet (assets, liabilities, equity) and cash flow per fiscal year, plus the company identity from the filing cover (razón social, status, CIIU, inco…
- [DIAN Electronic Document](https://docs.usecroma.com/api-reference/colombia/dian-electronic-document.md): Validate a Colombian electronic document (factura electrónica, nota crédito/débito) by its CUFE/UUID and the emisor or receptor NIT. Returns the issuer, recipient, totals and taxes, current legitimate holder, validations, and events.
- [DIAN Doctrina Search](https://docs.usecroma.com/api-reference/colombia/dian-doctrina-search.md): Full-text search over DIAN's published tax doctrine and related legal compilation: oficios, conceptos, decretos, resoluciones, leyes and high-court rulings. Each hit carries the `document_id` used by `dian-doctrina-document`, plus the title, issuing body, epigraph and a matching excerpt. Optional fi…
- [DIAN Doctrina Document](https://docs.usecroma.com/api-reference/colombia/dian-doctrina-document.md): Retrieve the text of one DIAN doctrine document by the `document_id` returned by `dian-doctrina-search`: the official title and the body of the oficio, concepto or norm. Compiled norms run to millions of characters, so the body is returned in character ranges: `content.total_length` is the full size…
- [SECOP Process by Notice](https://docs.usecroma.com/api-reference/colombia/secop-process-by-notice.md): Resolve a Colombian public-procurement process (SECOP II) by its OpportunityDetail noticeUID and return the process header, the per-provider award list, and every awarded contract: providers, documents, values, dates, and execution amounts. Sourced from Colombia Compra Eficiente's open data. `found:…
- [SECOP Processes by Entity](https://docs.usecroma.com/api-reference/colombia/secop-processes-by-entity.md): List the procurement processes (SECOP II) published by one contracting entity (by NIT), optionally within a publication-date window. The audit population for an entity. Returns lean summaries (drill into one with `secop-process`). Pages of 500, newest first (`page`, 1-based); `capped: true` means th…
- [SECOP Contract by ID](https://docs.usecroma.com/api-reference/colombia/secop-contract-by-id.md): Resolve one electronic contract (SECOP II) by its contract id and return the full contract record plus its satellite history: registered additions/modifications, insurance policies (garantías) with insurer and validity, and the delivery plan with planned vs actual progress. `found: false` when no co…
- [SECOP Contracts by Provider](https://docs.usecroma.com/api-reference/colombia/secop-contracts-by-provider.md): List the public-procurement contracts (SECOP II) awarded to one provider by cédula or NIT, across all contracting entities: the contractor profile (who hired them, values, status, dates). Optional filters: contracting-entity NIT and a sign-date window (`from_date`/`to_date`). Pages of 500, newest fi…
- [SECOP Sanctions by Provider](https://docs.usecroma.com/api-reference/colombia/secop-sanctions-by-provider.md): List the fines and sanctions (multas y sanciones) recorded against one state contractor by cédula or NIT: sanctioning entity, resolution number, value, and the dates the sanction was published and became final. A direct adverse signal for counterparty screening, from Colombia Compra Eficiente's open…
- [ANCP-CCE Conceptos Search](https://docs.usecroma.com/api-reference/colombia/ancp-cce-conceptos-search.md): Search conceptos (public-procurement legal opinions) from the Relatoría de la ANCP-CCE (Colombia Compra Eficiente) by free text, tema (descriptor), and modification date. Paginated, newest-modified first. Drill into one with `ancp-cce-concepto` for the full text.
- [ANCP-CCE Concepto](https://docs.usecroma.com/api-reference/colombia/ancp-cce-concepto.md): Retrieve one ANCP-CCE concepto by id or slug (e.g. `c-1094-de-2026`): full doctrinal text, dates, subjects and subtopics. `found: false` when nothing matches.
- [RUNT Vehicle by Plate](https://docs.usecroma.com/api-reference/colombia/runt-vehicle-by-plate.md): Resolve a Colombian vehicle in RUNT (Registro Único Nacional de Tránsito) by plate and the registered owner's document. Returns the vehicle record (brand, line, model year, class, body, color, engine displacement, fuel, weights, VIN, engine/chassis/serial numbers, traffic authority, registration dat…
- [RUNT Vehicle History by Plate](https://docs.usecroma.com/api-reference/colombia/runt-vehicle-history-by-plate.md): Look up a Colombian vehicle's history in RUNT (Registro Único Nacional de Tránsito) by plate alone, without the owner's document. Returns the registered owner(s) (name and identification number), the vehicle characteristics (brand, line, model year, class, body, color, VIN, engine/chassis/serial num…
- [SIMIT Account Status](https://docs.usecroma.com/api-reference/colombia/simit-account-status.md): Look up a SIMIT (Sistema Integrado de Información sobre Multas y Sanciones por Infracciones de Tránsito) account status by vehicle plate or by a person's identification number. Returns outstanding comparendos and multas (each with the offending party, infraction codes and descriptions, traffic autho…
- [Colombia Laws Search](https://docs.usecroma.com/api-reference/colombia/colombia-laws-search.md): Search Colombian legislation as structured data, sourced from Legalize. Filter by free text, law type, publication year, status, and jurisdiction. Returns paginated law summaries; use `per_page` and `page` to page. Drill into one with `legalize-law-detail`.
- [Colombia Law Detail](https://docs.usecroma.com/api-reference/colombia/colombia-law-detail.md): Resolve a single Colombian law by its identifier and return the full record, sourced from Legalize: metadata plus the law text as Markdown (`content_md`). `found: false` when no law matches the identifier.
- [SIATA Aburrá Valley Conditions](https://docs.usecroma.com/api-reference/colombia/siata-aburrá-valley-conditions.md): Live environmental conditions for the Aburrá Valley (Medellín metropolitan area) from SIATA: per-station weather (temperature, humidity, wind, pressure), rainfall (accumulated + intensity), and air quality (24h PM2.5 + ICA index). All inputs optional: an empty body returns every station; pass `latit…
- [SUNAT Taxpayer by RUC](https://docs.usecroma.com/api-reference/peru/sunat-taxpayer-by-ruc.md): Look up a Peruvian taxpayer's full record by RUC (11 digits). `found: false` when the RUC is not registered.
- [SUNAT Taxpayer by Document](https://docs.usecroma.com/api-reference/peru/sunat-taxpayer-by-document.md): Look up a Peruvian taxpayer's full record by identity document (DNI, carné de extranjería, passport, or diplomatic card). `found: false` when no taxpayer matches.
- [SUNAT Taxpayers by Name](https://docs.usecroma.com/api-reference/peru/sunat-taxpayers-by-name.md): Search Peruvian taxpayers by name or razón social. Returns up to 30 matches (SUNAT's cap).
- [RREE Foreigner Cards](https://docs.usecroma.com/api-reference/peru/rree-foreigner-cards.md): Verify a Peruvian foreigner identity card (carné de extranjería) by its 8-digit card number: names, nationality, immigration status, and expiration. `found: false` when no card matches.
- [SAT Lima Account Status](https://docs.usecroma.com/api-reference/peru/sat-lima-account-status.md): Look up outstanding debt owed to the SAT de Lima (Servicio de Administración Tributaria de Lima) for a person, company, or vehicle. Pass `document_type` (`dni`, `ruc`, `placa`, `papeleta`, `cod_administrado`, or `compromiso`; defaults to `dni`) plus `document_number`. Returns each outstanding item (…
- [SAT Lima Vehicle Capture Orders](https://docs.usecroma.com/api-reference/peru/sat-lima-vehicle-capture-orders.md): Check whether a vehicle plate has an outstanding capture order (orden de captura) in the province of Lima, issued by the SAT de Lima (Servicio de Administración Tributaria de Lima) for unpaid tax debt or traffic tickets. `has_capture_order: false` means the plate has no capture order on record. When…
- [Callao Traffic Tickets](https://docs.usecroma.com/api-reference/peru/callao-traffic-tickets.md): List the outstanding traffic tickets (papeletas) registered against a vehicle plate in the province of Callao, issued by the Municipalidad Provincial del Callao. `has_papeletas: false` means the plate has no outstanding tickets on record. When tickets exist, `papeletas` lists each one (code, ticket…
- [SUTRAN Infraction Record](https://docs.usecroma.com/api-reference/peru/sutran-infraction-record.md): Look up the infraction documents (papeletas and other actos) on record for a vehicle plate from SUTRAN (Superintendencia de Transporte Terrestre de Personas, Carga y Mercancías), Peru's national road-transport authority. `has_infractions: false` means the plate has no infractions on record. When inf…
- [APESEG SOAT Certificate History](https://docs.usecroma.com/api-reference/peru/apeseg-soat-certificate-history.md): Look up a vehicle plate's SOAT (mandatory traffic-accident insurance) certificate history from APESEG (Asociación Peruana de Empresas de Seguros). `has_active_soat: true` means a currently valid (VIGENTE) certificate exists, returned as `active`; `certificates` lists the full history. `found: false`…
- [SBS SOAT Report](https://docs.usecroma.com/api-reference/peru/sbs-soat-report.md): Look up a vehicle plate's SOAT (mandatory traffic-accident insurance) report from SBS (Superintendencia de Banca, Seguros y AFP), Peru's banking and insurance regulator. Returns `accident_count` (accidents covered by SOAT in the last 5 years) and `policies`, the list of SOAT policies on record (issu…
- [DOF Publications by Date](https://docs.usecroma.com/api-reference/mexico/dof-publications-by-date.md): Everything published in Mexico's official federal gazette (Diario Oficial de la Federación) on a given date: decrees, law reforms, and regulator disposiciones across the morning, evening, and extraordinary editions, each with its issuing branch and agency. History reaches back to 1995. `has_text: tr…
- [DOF Publication](https://docs.usecroma.com/api-reference/mexico/dof-publication.md): Retrieve one publication from Mexico's official federal gazette (DOF) by id, including its plain text when the publication is machine-readable. Publications range from a few hundred characters to entire decrees, so the text is returned in character ranges: `content.total_length` is the full size, an…
- [Mexican Federal Laws](https://docs.usecroma.com/api-reference/mexico/mexican-federal-laws.md): The complete catalog of Mexican federal laws and codes (315+, including the Constitution and recently abrogated laws, flagged `abrogated`), from the official compilation of the Cámara de Diputados. Each law carries its original publication date, last reform date, and links to the consolidated offici…
- [Mexican Federal Law](https://docs.usecroma.com/api-reference/mexico/mexican-federal-law.md): One federal law's full record: consolidated-text links plus the complete reform history (every decree that amended it, newest first, with DOF dates and official decree PDFs) and the original publication. Use the `id` from `diputados-federal-laws` (e.g. `lic`, `cpeum`).
- [Mexican Law Reforms by Year](https://docs.usecroma.com/api-reference/mexico/mexican-law-reforms-by-year.md): The chronological log of federal law reforms: one entry per DOF publication day (a day can bundle several instruments), newest first, with the affected laws and what happened to them (reforman/adicionan/derogan/abrogan/expiden/modifican/actualizan, plus fe de erratas). Defaults to the current year;…
- [Mexican Federal Regulations](https://docs.usecroma.com/api-reference/mexico/mexican-federal-regulations.md): The catalog of federal reglamentos in force (135+), each with its DOF publication date, consolidated-text links, and inline amendment history (original, reforms, and annual amount updates). Optional `query` filters by name. Paged, 50 per page.
- [CNBV Regulations](https://docs.usecroma.com/api-reference/mexico/cnbv-regulations.md): The CNBV's current regulatory catalog (~113 normas: leyes, disposiciones de carácter general including the Circular Única de Bancos, circulares, acuerdos, reglas), each with type, DOF publication date, applicable sectors, and the official PDF. Optional `query` filters by name. Paged, 50 per page. No…
- [CNBV Regulation History](https://docs.usecroma.com/api-reference/mexico/cnbv-regulation-history.md): Every modifying resolución and annex for one CNBV norma (by `regulation_id` from `cnbv-regulations`), each with its DOF date and official PDF. The Circular Única de Bancos alone carries 180+ modifications.
- [Banxico Circulars](https://docs.usecroma.com/api-reference/mexico/banxico-circulars.md): The chronological index of every circular and disposición issued by Banco de México (1,200+ entries back to 1969), each with subject, abrogation status, and which base circular it modifies. One row per index entry: a circular amending several bases appears once per base. Optional `year` filters one…
- [Banxico Circular](https://docs.usecroma.com/api-reference/mexico/banxico-circular.md): One Banco de México circular in full, by its `number`: subject, obligated entities, the consolidated (compiled) text PDF, the original text PDF with its DOF date, and every modification with dates and PDFs. Amendment circulars have no page of their own: looking one up returns the amended base circul…
- [SCJN Tesis Search](https://docs.usecroma.com/api-reference/mexico/scjn-tesis-search.md): Search Mexican Supreme Court case-law (tesis) from the SCJN's unified legal search. Covers the full Semanario Judicial corpus (300k+ tesis). Filter by binding force (`tesis_type`: jurisprudencia vs aislada), subject (materia), época number, and year. Results include highlighted snippets and `facets`…
- [SCJN Tesis](https://docs.usecroma.com/api-reference/mexico/scjn-tesis.md): Retrieve one tesis by its registro digital (`registration_number`), including the full text, citation (clave, época, localización), subjects, precedent notes, and linked ruling ids.
- [FGR Bulletins](https://docs.usecroma.com/api-reference/mexico/fgr-bulletins.md): Browse the public press bulletins (comunicados) of the federal prosecutor (FGR), most recent first; page forward with `page` until `has_more` is false. Each item carries its bulletin `code`, `scope` (national or state), date, and headline, and links to the full comunicado. These are public press rel…
- [Fiscalía CDMX Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-cdmx-bulletins.md): Browse the public press bulletins (comunicados) of the Mexico City prosecutor, most recent first, paged with `page` (10 per page). Each bulletin carries its comunicado `code`, date, headline, and summary. These are public press releases, not a criminal-record database: a name in a bulletin is an ind…
- [Fiscalía Chiapas Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-chiapas-bulletins.md): Browse the public press bulletins (comunicados) of the Chiapas state prosecutor, most recent first; page forward with `page` until `has_more` is false. Each bulletin carries its comunicado number, classification, date, headline, and summary. These are public press releases, not a criminal-record dat…
- [Fiscalía Chihuahua Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-chihuahua-bulletins.md): Search the public press bulletins (comunicados) of the Chihuahua state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Optional `from_date`/`to_date` bound the range. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence); the `categor…
- [Fiscalía Estado de México Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-estado-de-méxico-bulletins.md): Browse the public press bulletins (comunicados) of the Estado de México prosecutor, most recent first; page forward with `page` until `has_more` is false. Each bulletin carries its comunicado `code`, date, headline, and a link to the full document. These are public press releases, not a criminal-rec…
- [Fiscalía Jalisco Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-jalisco-bulletins.md): Search the public press bulletins (comunicados) of the Jalisco state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence) and carries the issuing author and tags. These are public press…
- [Fiscalía Nuevo León Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-nuevo-león-bulletins.md): Search the public press bulletins (comunicados) of the Nuevo León prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Each bulletin carries its date, headline, and summary. These are public press releases, not a criminal-record database: a name in a bulletin is an indicio…
- [Fiscalía Puebla Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-puebla-bulletins.md): Search the public press bulletins (comunicados) of the Puebla state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Each bulletin carries its numbered boletín, date, and headline. These are public press releases, not a criminal-record database: a name in a bulletin is…
- [Fiscalía Veracruz Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-veracruz-bulletins.md): Search the public press bulletins (comunicados) of the Veracruz state prosecutor. Free-text `query` searches the corpus; omit it for the most recent. Optional `from_date`/`to_date` bound the range. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence). These are pub…
- [Fiscalía Zacatecas Bulletins](https://docs.usecroma.com/api-reference/mexico/fiscalía-zacatecas-bulletins.md): Browse the public press bulletins (comunicados) of the Zacatecas state prosecutor, most recent first; page forward with `page` until `has_more` is false. Each bulletin announces one procedural event (arrest, imputation, conviction, sentence) and carries the full text. These are public press releases…
- [SIEM Establishments Search](https://docs.usecroma.com/api-reference/mexico/siem-establishments-search.md): Search Mexican business establishments in the SIEM directory by commercial name or razón social. Optional filters narrow by state (INEGI code) and SCIAN activity. SIEM is a self-declared directory: registration is voluntary and each establishment chooses which fields stay public, so absence is not e…
- [SIEM Establishment](https://docs.usecroma.com/api-reference/mexico/siem-establishment.md): Retrieve one SIEM establishment's declared profile: RFC, legal or personal name, commercial name, activity, address and contact, headcount, import/export flags, declared products and services, and registration status. Returns `found: false` when the id is unknown.
- [Web Search](https://docs.usecroma.com/api-reference/global/web-search.md): AI-powered web search. Returns structured results with URLs, titles, authors, dates, highlights, and relevance scores.
- [Extract Markdown](https://docs.usecroma.com/api-reference/global/extract-markdown.md): Turn any public web page into clean Markdown. `scope` keeps either the article body or the whole page, and `include_metadata` adds the page's title, author and dates. Handles pages that render themselves in the browser at `effort: max`.
- [Extract JSON](https://docs.usecroma.com/api-reference/global/extract-json.md): Pull structured data off any public web page. You supply a JSON Schema describing the object you want and the fields are located on the page and returned under `result`, already typed.
- [Generate JSON](https://docs.usecroma.com/api-reference/global/generate-json.md): Read a public web page and return a new object built from it, following your `instructions` and your JSON Schema. Unlike `extract-json`, the fields need not appear on the page: summarize, classify, translate or reshape what is there.
- [Research](https://docs.usecroma.com/api-reference/global/research.md): Answer an open question from live sources. Returns a written report in Markdown with numbered citations plus the list of sources behind it. Typically takes 10-30 seconds; it is a research pass, not a lookup, so verify anything you act on against the primary source.
- [Get Job Status](https://docs.usecroma.com/api-reference/jobs/get-job-status.md): Poll the status and result of an async job created by an async-capable endpoint. Returns the job envelope; `data` is populated once `status` is `completed`, `error` once it is `failed`. Jobs are org-scoped — another org's job reads as 404.

## OpenAPI Specs

- [openapi](https://docs.usecroma.com/api-reference/openapi.json)