La API de FacturaHub es una API REST que te deja operar toda tu facturación desde tu código, sin pasar por el dashboard: creas facturas, clientes, gastos y declaraciones, emites Verifactu y consultas métricas, todo con JSON sobre HTTPS. Es el mismo backend que usan la app web, el agente de WhatsApp y el servidor MCP, así que cualquier dato que crees por API aparece al instante en los tres canales.
La autenticación es dual y eliges según tu caso:
x-api-key — tu clave en la cabecera. Lo más cómodo para integraciones servidor-a-servidor (scripts, cron, tu propio backend). La generas desde los ajustes de tu cuenta.Authorization: Bearer <JWT> — un token JWT. Úsalo si ya tienes una sesión de usuario.Los endpoints cubren el negocio entero. Cada recurso soporta las operaciones REST habituales (GET listar/consultar, POST crear, PATCH/PUT actualizar, DELETE borrar):
/api/invoices — facturas/api/clients — clientes y CRM/api/expenses — gastos (con escaneo OCR)/api/catalog — productos y servicios/api/tasks — tareas/api/teams — equipos y permisos/api/vendors y /api/supplier-invoices — proveedores y facturas recibidas/api/tax-declarations — Modelo 303 y otras declaraciones/api/einvoice — factura electrónica (Verifactu en España)/api/cash-register — caja/api/context — la memoria viva de tu negocio que comparte con la IAcurl -X POST https://api.facturahub.com/api/invoices \
-H "x-api-key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"client": { "name": "Acme SL", "taxId": "B12345678", "country": "ES" },
"items": [{ "description": "Consultoria", "quantity": 1, "unitPrice": 1000 }],
"taxRate": 21,
"retentionRate": 15,
"issueDate": "2026-06-18"
}'Para emitir factura electrónica en España, primero creas la factura y luego la emites con POST /api/einvoice (o el endpoint legacy de Verifactu): FacturaHub firma el registro, lo manda a la AEAT vía Verifactu y te devuelve el identificador fiscal, el QR y el estado. Para el IVA trimestral, POST /api/tax-declarations/generate con {country:"ES", year, period} te devuelve todas las casillas del Modelo 303 calculadas desde tus facturas y gastos reales, listas para que tú o tu gestor las presentéis.
Toda la API está documentada y es navegable:
https://facturahub.com/openapi.json — importable en Postman, Insomnia o cualquier generador de SDK.https://facturahub.com/api-docs/ — prueba los endpoints desde el navegador.https://github.com/Santy1422/facturahub-api — código en cURL, JavaScript, Python y PHP.El plan es gratis y todo es ilimitado: facturas, clientes, gastos, llamadas a la API, Verifactu, Modelo 303 y exportación en CSV y PDF. Lo único que se mide es la IA: 25 acciones de IA gratis al mes (por ejemplo un OCR de ticket), y si necesitas más compras un pack de tokens de pago único desde 4,99 € que no caduca. No hay planes Starter/Growth/Pro ni prueba de 7 días, y crear facturas o clientes por API normal no consume IA.
Honestidad sobre lo que aún no está listo (no lo anunciamos como disponible):
invoice.paid que llamen a tu URL cuando algo cambia./v1 — hoy la API vive bajo /api.Mientras tanto, trabajas contra tu cuenta real y puedes usar facturas en borrador para probar sin emitir nada fiscal.
Crea, lee, actualiza y borra recursos con HTTP estándar. Mismo backend que la web, WhatsApp y MCP: lo que creas por API aparece al instante en los tres canales.
Usa tu clave de API en la cabecera x-api-key para integraciones servidor-a-servidor, o un token JWT en Authorization: Bearer si ya tienes sesión de usuario.
invoices, clients, expenses, catalog, tasks, teams, vendors, supplier-invoices, tax-declarations, e-invoice, cash-register y context. La facturación completa por API.
Crea la factura y emitela con POST /api/einvoice. FacturaHub firma el registro, lo manda a la AEAT via Verifactu y devuelve identificador fiscal, QR y estado.
POST /api/tax-declarations/generate con {country:"ES", year, period} devuelve todas las casillas del 303 calculadas desde tus datos reales.
Spec pública en facturahub.com/openapi.json (importable en Postman/Insomnia) y Swagger UI navegable en facturahub.com/api-docs para probar desde el navegador.
Repositorio público con ejemplos en cURL, JavaScript, Python y PHP: github.com/Santy1422/facturahub-api.
Sandbox público de pruebas, webhooks salientes (invoice.paid y similares) y base path versionado /v1. Honestos: aún no están, están en el roadmap.
De dos formas: con tu clave de API en la cabecera x-api-key (ideal para scripts y servidores), o con un token JWT en Authorization: Bearer (si ya tienes sesión de usuario). Generas tu clave desde los ajustes de tu cuenta.
La spec OpenAPI 3.1 está en facturahub.com/openapi.json y el Swagger UI navegable en facturahub.com/api-docs. Hay ejemplos en cURL, JavaScript, Python y PHP en el repo de GitHub: github.com/Santy1422/facturahub-api.
Practicamente todo el negocio: facturas, clientes, gastos, catálogo de productos, tareas, equipos, proveedores y facturas recibidas, declaraciones fiscales (Modelo 303), factura electrónica (Verifactu), caja y el contexto del negocio.
Sí. Creas la factura y la emites con POST /api/einvoice. FacturaHub firma el registro, lo envía a la AEAT via Verifactu y te devuelve el identificador fiscal, el QR y el estado de la factura electrónica.
Aun no, y preferimos ser honestos: el sandbox público, los webhooks salientes (invoice.paid y similares) y el base path versionado /v1 están en el roadmap como próximamente. Mientras tanto puedes probar con facturas en borrador, que no emiten nada fiscal.
Nada: el plan es gratis y las llamadas a la API son ilimitadas. Solo se mide la IA — 25 acciones de IA gratis al mes (como un OCR de ticket) y packs de tokens de pago único desde 4,99 € si necesitas más. Crear facturas o clientes por API normal no consume IA.
Sí. La API usa el mismo backend que la web, el agente de WhatsApp y el servidor MCP. Lo que creas por API aparece al instante en el dashboard y al reves: una sola fuente de datos para todos los canales.