Documentación de la API pública — Hub Fiscal MX
API REST de lectura pública para datos fiscales mexicanos: tipo de cambio FIX Banxico, UMA, INPC, tarifas ISR, catálogos CFDI 4.0, calendario fiscal y validador RFC. Sin autenticación, CORS abierto, 60 peticiones por minuto por IP, licencia CC BY 4.0.
- Base URL:
https://hubfiscal.mx/api/v1/public - Spec OpenAPI 3.1 (JSON): /api/v1/public/openapi.json
- Documentación interactiva (Swagger UI): disponible al cargar esta página con JavaScript activado.
Tipo de cambio FIX Banxico
Tipo de cambio USD/MXN publicado por Banco de México (serie SF43718). Actualizado cada día hábil.
| Método y ruta | Descripción | Parámetros |
|---|---|---|
GET /fx/today | FIX USD/MXN más reciente | — |
GET /fx/history | Histórico FIX (default 30 días, máx 365) | days (query, integer, 1–365) |
# FIX más reciente
curl https://hubfiscal.mx/api/v1/public/fx/today
# Respuesta ejemplo
{"date":"2025-06-18","rate":17.23,"source":"Banxico SF43718"}
# Histórico de 7 días
curl "https://hubfiscal.mx/api/v1/public/fx/history?days=7"UMA y salario mínimo
Unidad de Medida y Actualización (UMA) y salario mínimo general vigente. Actualización anual (1 febrero).
| Método y ruta | Descripción | Parámetros |
|---|---|---|
GET /uma | UMA y factores IMSS del año vigente | — |
GET /uma/{year} | UMA y factores IMSS de un año específico | year (path, integer, p. ej. 2024) |
# UMA vigente
curl https://hubfiscal.mx/api/v1/public/uma
# Respuesta ejemplo
{"year":2025,"uma":108.57,"salarioMinimo":278.80,"employeeRate":0.0225,"employerRate":0.1025}
# UMA de 2023
curl https://hubfiscal.mx/api/v1/public/uma/2023INPC (Inflación)
Índice Nacional de Precios al Consumidor publicado por INEGI. Publicación mensual alrededor del día 9.
| Método y ruta | Descripción | Parámetros |
|---|---|---|
GET /inpc | Serie INPC reciente (default 24 meses, máx 120) | limit (query, integer, 1–120) |
GET /inpc/{period} | INPC de un periodo YYYY-MM específico | period (path, string, p. ej. 2025-01) |
# INPC de los últimos 12 meses
curl "https://hubfiscal.mx/api/v1/public/inpc?limit=12"
# INPC enero 2025
curl https://hubfiscal.mx/api/v1/public/inpc/2025-01
# Respuesta ejemplo
{"period":"2025-01","value":131.20}Tarifas ISR
Tarifas ISR mensuales y anuales del Art. 96 LISR para retención en sueldos y salarios. Fuente: SAT / RMF vigente.
| Método y ruta | Descripción | Parámetros |
|---|---|---|
GET /tarifa/isr/mensual | Tarifa ISR mensual (Art. 96 LISR) vigente | — |
GET /tarifa/isr/{year}/{period} | Tarifa ISR de un año y periodo específico | year (path), period (path): mensual | anual | quincenal | semanal | diaria |
# Tarifa ISR mensual vigente
curl https://hubfiscal.mx/api/v1/public/tarifa/isr/mensual
# Tarifa ISR anual 2024
curl https://hubfiscal.mx/api/v1/public/tarifa/isr/2024/anual
# Respuesta ejemplo (fragmento)
{"year":2025,"period":"mensual","rows":[
{"lowerLimit":0.01,"upperLimit":746.04,"fixedQuota":0,"marginalRate":0.0192},
{"lowerLimit":746.05,"upperLimit":6332.05,"fixedQuota":14.32,"marginalRate":0.0640}
]}Catálogos CFDI 4.0
Siete catálogos oficiales del SAT para emitir, recibir y validar facturas electrónicas (CFDI 4.0). Se actualizan con cada versión de los catálogos publicada en el SAT.
| Método y ruta | Catálogo |
|---|---|
GET /cfdi/uso/{code} | Uso del CFDI (c_UsoCFDI) |
GET /cfdi/forma-pago/{code} | Forma de pago (c_FormaPago) |
GET /cfdi/metodo-pago/{code} | Método de pago (c_MetodoPago) |
GET /cfdi/regimen/{code} | Régimen fiscal (c_RegimenFiscal) |
GET /cfdi/tipo-comprobante/{code} | Tipo de comprobante (c_TipoDeComprobante) |
GET /cfdi/moneda/{code} | Moneda (c_Moneda) |
GET /cfdi/clave-prod-serv | Clave de Producto/Servicio — lista paginada (default 100, máx 500) |
GET /cfdi/clave-prod-serv/{code} | Lookup individual en c_ClaveProdServ |
# Uso CFDI "G03" (Gastos en general)
curl https://hubfiscal.mx/api/v1/public/cfdi/uso/G03
# Respuesta ejemplo
{"code":"G03","description":"Gastos en general","plain":"Gastos en general"}
# Régimen fiscal "612" (Personas Físicas con Actividades Empresariales)
curl https://hubfiscal.mx/api/v1/public/cfdi/regimen/612
# Clave de Producto/Servicio paginada (primeras 50 entradas)
curl "https://hubfiscal.mx/api/v1/public/cfdi/clave-prod-serv?limit=50&offset=0"Validador de RFC
Valida la estructura de un RFC mexicano: longitud, fecha de nacimiento/constitución y dígito verificador. No consulta listas negras del SAT.
| Método y ruta | Descripción | Parámetros |
|---|---|---|
GET /rfc/validar/{rfc} | Resultado de validación estructural del RFC | rfc (path, string) |
# RFC de persona física
curl https://hubfiscal.mx/api/v1/public/rfc/validar/VECJ880326XXX
# Respuesta ejemplo
{"rfc":"VECJ880326XXX","valid":true,"type":"fisica","message":"RFC válido"}
# RFC inválido
curl https://hubfiscal.mx/api/v1/public/rfc/validar/INVALIDO
{"rfc":"INVALIDO","valid":false,"type":null,"message":"Longitud inválida"}Calendario fiscal
Vencimientos fiscales de SAT, IMSS e INFONAVIT. Cubre declaraciones mensuales, bimestrales, anuales y retenciones patronales.
| Método y ruta | Descripción | Parámetros |
|---|---|---|
GET /calendario/proximos | Próximos 10 vencimientos fiscales a partir de hoy | — |
# Próximos vencimientos
curl https://hubfiscal.mx/api/v1/public/calendario/proximos
# Respuesta ejemplo (fragmento)
[
{"id":1,"title":"Declaración mensual ISR e IVA (RIF)","date":"2025-07-17","category":"SAT","summary":"Personas físicas RIF/RESICO"},
{"id":2,"title":"Pago cuotas IMSS","date":"2025-07-17","category":"IMSS","summary":"Cuotas obrero-patronales bimestral"}
]Contenido — Calculadoras, Artículos y Glosario
| Método y ruta | Descripción |
|---|---|
GET /tools | Catálogo de calculadoras fiscales disponibles en Hub Fiscal MX |
GET /articles | Catálogo de artículos y guías fiscales |
GET /glossary | Catálogo de términos del glosario fiscal |
GET /suggest?q=... | Sugerencias inteligentes para páginas no encontradas (404) |
Límites, headers y caché
- Rate limit: 60 peticiones por minuto por IP. Sin autenticación requerida.
- CORS: abierto (
Access-Control-Allow-Origin: *). Usable desde el navegador directamente. - Headers de rate limit:
x-fmx-rate-limit,x-fmx-rate-limit-remaining,x-fmx-rate-limit-reset. - Caché recomendada: FIX y INPC → 5 minutos. UMA y tarifas ISR → 1 hora. CFDI → 24 horas.
- Licencia: CC BY 4.0. Atribución requerida: "Según Hub Fiscal MX (https://hubfiscal.mx)".
Discovery para clientes de IA y LLMs
- /.well-known/ai-plugin.json — manifest para plugins OpenAI.
- /.well-known/mcp.json — manifest MCP para Claude y otros clientes.
- /llms.txt — guía para crawlers LLM (robots para modelos de lenguaje).
- /llms-full/index.json — manifest sharded de contenido completo.
- /api/v1/public/openapi.json — spec OpenAPI 3.1 completa en JSON.