{"openapi":"3.1.0","info":{"title":"Observatorio CFDI API","version":"2026-09-24","description":"Estadísticas oficiales, comparador y estado en vivo de los proveedores de certificación de CFDI de México (PAC, o PCCFDI en la RMF) y del facturador gratuito del SAT: participación de mercado, precios públicos, API, disponibilidad y caídas. Datos abiertos para personas y agentes de IA.","x-llms-txt":"/llms.txt"},"servers":[{"url":"https://observatorio.app.corderoai.com"}],"components":{"securitySchemes":{"llavePro":{"type":"http","scheme":"bearer","description":"Llave de suscriptor Pro"}}},"paths":{"/api/v1":{"get":{"summary":"Índice del API: endpoints, precios y cómo pagar.","tags":["gratis"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/pacs":{"get":{"summary":"Los 49 PAC de la lista oficial del SAT y el facturador del SAT: segmento, API conocida, participación de mercado, autorización vigente o revocada y estado actual del servicio gratuito.","tags":["gratis"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/pacs/{slug}":{"get":{"summary":"Ficha de un proveedor: perfil verificado, fuentes, participación de mercado y estado actual.","tags":["gratis"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Slug del proveedor, como en /api/v1/pacs"}],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/estado":{"get":{"summary":"Estado actual del servicio gratuito de todos los proveedores (última corrida).","tags":["gratis"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/mercado":{"get":{"summary":"El mercado en cifras oficiales del SAT: totales, los 10 primeros por facturas y por contribuyentes, bajas recientes y fecha de corte.","tags":["gratis"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/costos":{"get":{"summary":"Precios públicos del timbrado en México (PAC, revendedores y SAT), cada uno con fuente y fecha.","tags":["gratis"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/premium/mercado/series":{"get":{"summary":"Series completas 2011–hoy de facturas y contribuyentes de los 50 PAC, con participación, posición y crecimiento por año.","tags":["pago"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Pago requerido: $0.02 USD por consulta vía x402 (cabecera PAYMENT-REQUIRED). Con llave Pro (Authorization: Bearer) no se cobra."},"503":{"description":"Cobro por consulta no activado en este despliegue; el cuerpo explica cómo acceder."}},"x-x402-price":"$0.02","security":[{"llavePro":[]},{}]}},"/api/v1/premium/pacs/{slug}/historial":{"get":{"summary":"Historial completo de verificaciones de un proveedor: fecha, código, detalle y latencia.","tags":["pago"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Slug del proveedor, como en /api/v1/pacs"}],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Pago requerido: $0.01 USD por consulta vía x402 (cabecera PAYMENT-REQUIRED). Con llave Pro (Authorization: Bearer) no se cobra."},"503":{"description":"Cobro por consulta no activado en este despliegue; el cuerpo explica cómo acceder."}},"x-x402-price":"$0.01","security":[{"llavePro":[]},{}]}},"/api/v1/premium/benchmark":{"get":{"summary":"Benchmark completo: disponibilidad, latencia mediana, rachas, participación de mercado y ranking de todos los proveedores.","tags":["pago"],"parameters":[],"responses":{"200":{"description":"JSON con fecha de verificación y fuente","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Pago requerido: $0.05 USD por consulta vía x402 (cabecera PAYMENT-REQUIRED). Con llave Pro (Authorization: Bearer) no se cobra."},"503":{"description":"Cobro por consulta no activado en este despliegue; el cuerpo explica cómo acceder."}},"x-x402-price":"$0.05","security":[{"llavePro":[]},{}]}}}}