# MéxicoAPI

> Datos de referencia de México con fuente oficial, licencia y sha256: catálogos, indicadores, calendarios y constantes, en una API JSON de solo lectura y en descargas completas en JSON, CSV y SQLite.

La API no pide llave ni cuenta y vive en `/v1`, en el mismo origen que este archivo; `GET /v1` responde un índice en JSON. La API pública es `https://mexicoapi.dagel4k.workers.dev`, la base de los ejemplos de la documentación. Las rutas de datos responden `{ "data": …, "meta": … }`: `meta` trae `dataset`, `as_of`, `sources` (nombre, URL, licencia y cita de cada fuente oficial) y `docs`. Los errores responden `application/problem+json`. Las fechas van en `AAAA-MM-DD`. La API también valida CLABE y suma días hábiles: esas rutas están en Docs.

Si la API responde 404 `dato-no-disponible` o 422 `calendario-incompleto`, ese dato no está en MéxicoAPI (todavía no se carga o queda fuera de la cobertura del calendario): no lo inventes ni lo estimes. Dilo así y remite a la fuente oficial que nombra la documentación del dataset.

El FIX de hoy para un pago: usa `operacion` con la fecha del pago (`GET /v1/tipo-cambio/fix?operacion={fecha}`), que responde el último publicado en el DOF antes de ese día, el que aplica, con su fundamento. No tomes `/v1/tipo-cambio/fix/ultimo` como el FIX de hoy: es la publicación más reciente, que si salió hoy aplica a los pagos de mañana. `fecha_publicacion` es la fecha del DOF; Banxico muestra la misma cifra un día hábil bancario antes, con su fecha de determinación. Las fechas son días de la Ciudad de México (America/Mexico_City): en un servidor en UTC, desde las 18:00 de la Ciudad de México ya es el día siguiente. Con `publicado`, un 404 `no-encontrado` en fin de semana o feriado bancario significa que ese día no hubo publicación: no es un error ni falta un dato.

En Datos, `as_of` es la fecha de la última actualización que cambió el dataset (en los curados, la de su publicación oficial más reciente). En las series (FIX y UDIS), el último dato es la fecha de su registro más reciente y va aparte: el FIX no se publica en fines de semana ni en feriados bancarios, y las UDIS se publican por adelantado.

También hay un paquete de npm con validadores de CLABE, RFC, CURP y NSS (formato y dígito verificador, en tu equipo; en el RFC, el dígito es informativo), los mismos datos sin red y un cliente de la API (`npm install mexicoapi`), y un servidor MCP por stdio con los mismos datos y validadores como herramientas (`npx -y mexicoapi-mcp`).

## Docs

- [Referencia de la API](https://github.com/Dagel4k/mexicoapi/blob/main/docs/api/README.md): rutas, parámetros, ejemplos de respuesta, caché, CORS y límite de peticiones
- [Errores](https://github.com/Dagel4k/mexicoapi/blob/main/docs/api/problemas.md): cada tipo de `application/problem+json` y qué significa
- [GET /v1/clabe/{clabe}](https://github.com/Dagel4k/mexicoapi/blob/main/docs/api/README.md#clabe): valida una CLABE de 18 dígitos: formato, dígito verificador y banco
- [GET /v1/dias-habiles?autoridad={lft|cnbv|sat}&desde={fecha}&dias={n}](https://github.com/Dagel4k/mexicoapi/blob/main/docs/api/README.md#dias-habiles): suma días hábiles a una fecha con el calendario de la LFT (sábados, domingos y art. 74; no incluye los festivos ni las suspensiones de labores del art. 715), la CNBV (calendario bancario) o el SAT; con `autoridad=sat`, `tipo_plazo` (`general` o `declaraciones_pagos`) es obligatorio. `desde` es el día en que surte efectos la notificación, no el día en que se hizo, y `advertencias` dice lo que el cálculo no descuenta
- [GET /v1/tipo-cambio/fix?operacion={fecha}](https://github.com/Dagel4k/mexicoapi/blob/main/docs/api/README.md#publicado-y-operación): el FIX que aplica a un pago o una operación de esa fecha: el último publicado en el DOF antes de ese día (CFF art. 20; para una obligación en dólares es la misma publicación que manda el art. 172 de la Circular 3/2012 del Banco de México: las dos reglas solo se separarían si el DOF no publicara el FIX un día hábil bancario o lo publicara uno inhábil, y entonces la ruta sigue al CFF). Úsala cuando pregunten por "el FIX de hoy" para pagar
- [GET /v1/tipo-cambio/fix/ultimo](https://github.com/Dagel4k/mexicoapi/blob/main/docs/api/README.md#último): la publicación más reciente del tipo de cambio FIX; no es el FIX de hoy para un pago (ver `operacion`)
- [OpenAPI](/v1/openapi.json): especificación OpenAPI 3.1 de todas las rutas
- [Documentación completa](/llms-full.txt): la referencia, los errores y la documentación de cada dataset en un solo archivo

## Datos

- [Estados](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/inegi-estados.md): `inegi.estados`, as_of 2026-10-17, `GET /v1/estados`
- [Municipios](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/inegi-municipios.md): `inegi.municipios`, as_of 2026-10-17, `GET /v1/municipios` (todos los del país); también `GET /v1/estados/{cve_ent}/municipios` (los de un estado)
- [Bancos y participantes del SPEI](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/bancos.md): `bancos`, as_of 2026-10-17, `GET /v1/bancos`
- [Tipo de cambio FIX](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/tipo-cambio-fix.md): `tipo-cambio.fix`, as_of 2026-10-20, último dato 2026-10-20, `GET /v1/tipo-cambio/fix?operacion={fecha}` (el que aplica a un pago o una operación de esa fecha); también `GET /v1/tipo-cambio/fix/ultimo` (la publicación más reciente) y `GET /v1/tipo-cambio/fix?publicado={fecha}` (el que publicó el DOF ese día)
- [UDIS](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/udis.md): `udis`, as_of 2026-10-18, último dato 2026-10-25, `GET /v1/udis?fecha={fecha}`
- [Días inhábiles de la CNBV](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/dias-inhabiles-cnbv.md): `dias-inhabiles.cnbv`, as_of 2025-12-10, `GET /v1/dias-inhabiles?autoridad=cnbv&anio={anio}`
- [Días inhábiles del SAT](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/dias-inhabiles-sat.md): `dias-inhabiles.sat`, as_of 2026-07-09, `GET /v1/dias-inhabiles?autoridad=sat&anio={anio}`
- [UMA](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/constantes-uma.md): `constantes.uma`, as_of 2026-01-09, `GET /v1/constantes/uma?fecha={fecha}`
- [Salario mínimo](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/constantes-salario-minimo.md): `constantes.salario-minimo`, as_of 2025-12-09, `GET /v1/constantes/salario-minimo/{anio}`
- [Tarifas de ISR](https://github.com/Dagel4k/mexicoapi/blob/main/docs/datos/isr-tarifas.md): `isr.tarifas`, as_of 2025-12-28, `GET /v1/isr/tarifa/{periodo}/{anio}`

## Páginas

- [Días inhábiles del SAT 2026 y 2027 · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/dias-inhabiles-sat/)
- [Días de descanso obligatorio 2026 y 2027 \(LFT\) · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/dias-de-descanso-obligatorio/)
- [Días inhábiles bancarios 2026 \(CNBV\) · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/dias-inhabiles-bancarios/)
- [Calculadora de días hábiles: SAT, LFT y bancos · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/calculadora-dias-habiles/)
- [Tipo de cambio FIX del DOF · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/tipo-de-cambio-fix/)
- [Valor de la UDI de hoy y de los próximos días · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/udis/)
- [UMA 2026: valor diario, mensual y anual · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/uma/)
- [Salario mínimo 2026: general y frontera norte · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/salario-minimo/)
- [Tarifas de ISR 2026: mensual y anual · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/tarifas-isr/)
- [Códigos de banco de la CLABE · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/bancos-clabe/)
- [Validador de CLABE · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/validar-clabe/)
- [Estados y municipios de México con sus claves · MéxicoAPI](https://mexicoapi.dagel4k.workers.dev/municipios/)

## Optional

- [Descargas](/descargas/SHA256SUMS): cada dataset en JSON y CSV, todo junto en `/descargas/mexicoapi.sqlite`; SHA256SUMS trae el sha256 de cada archivo
- [Diseño técnico](https://github.com/Dagel4k/mexicoapi/blob/main/docs/diseno/arquitectura-v1.md): arquitectura, fuentes, pipeline de datos y decisiones
- [Seguridad](https://github.com/Dagel4k/mexicoapi/blob/main/SECURITY.md): cómo reportar una vulnerabilidad