API REST de Frihet

Acceso programático a facturas, clientes, gastos, productos y presupuestos. Diseñada para integraciones que escalan.

https://api.frihet.io/v1 v1 — 2026-03-18

Hecha para desarrolladores

Actualizaciones parciales PATCH

Actualiza solo los campos que necesitas. Schemas parciales validados con Zod garantizan la integridad.

Búsqueda y filtros

Búsqueda full-text con parámetro ?q=. Mapeo de campos por recurso para resultados precisos.

Operaciones batch

Crea hasta 50 recursos en una sola petición. Respuestas HTTP 207 multi-status.

Claves de idempotencia

Reintenta peticiones de forma segura con el header Idempotency-Key. TTL de 24 horas, respaldado por Firestore.

Headers de límite de tasa

X-RateLimit-Limit, Remaining y Reset en cada respuesta. Planifica en consecuencia.

Spec OpenAPI 3.1

Especificación legible por máquinas en /openapi.yaml. 16 paths, 18 schemas. Genera SDKs automáticamente.

Endpoints de inteligencia

Contexto de negocio, resúmenes mensuales y datos fiscales trimestrales vía /context, /monthly, /quarterly.

Eliminación segura VeriFactu

Soft delete para facturas y presupuestos no borrador. Trazabilidad completa para cumplimiento fiscal español.

Endpoints

Method	Path	Description
GET	/v1/invoices	Listar facturas
POST	/v1/invoices	Crear factura
PATCH	/v1/invoices/:id	Actualizar factura
DELETE	/v1/invoices/:id	Eliminar factura
POST	/v1/invoices/batch	Crear facturas en batch
GET	/v1/clients	Listar clientes
POST	/v1/clients	Crear cliente
GET	/v1/expenses	Listar gastos
POST	/v1/expenses	Crear gasto
GET	/v1/products	Listar productos
GET	/v1/quotes	Listar presupuestos
GET	/v1/context	Contexto de negocio
GET	/v1/monthly	Resumen mensual
GET	/v1/quarterly	Impuestos trimestrales
GET	/openapi.yaml	Especificación OpenAPI

Ejemplos de código

curl https://api.frihet.io/v1/invoices \
  -H "Authorization: Bearer fri_..." \
  -H "Content-Type: application/json"

const res = await fetch('https://api.frihet.io/v1/invoices', {
  headers: {
    'Authorization': 'Bearer fri_...',
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await res.json();

import requests

res = requests.get(
    'https://api.frihet.io/v1/invoices',
    headers={'Authorization': 'Bearer fri_...'}
)
data = res.json()['data']

Autenticación

Genera claves API desde Ajustes > API en tu panel de Frihet. Incluye tu clave como Bearer token en el header Authorization.

Authorization: Bearer fri_...

Documentación completa de la API MCP Server

Empieza a integrar hoy

Acceso a la API incluido en todos los planes. Tu clave API está lista en Ajustes.

Empezar Gratis