Frihet REST API

Programmatic access to invoices, clients, expenses, products, and quotes. Built for integrations that scale.

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

Built for developers

PATCH partial updates

Update only the fields you need. Zod-validated partial schemas ensure data integrity.

Search & filter

Full-text search with ?q= parameter. Per-resource field mapping for precise results.

Batch operations

Create up to 50 resources in a single request. HTTP 207 multi-status responses.

Idempotency keys

Safely retry requests with Idempotency-Key header. 24-hour TTL, Firestore-backed.

Rate limit headers

X-RateLimit-Limit, Remaining, and Reset headers on every response. Plan accordingly.

OpenAPI 3.1 spec

Machine-readable spec at /openapi.yaml. 16 paths, 18 schemas. Generate SDKs automatically.

Intelligence endpoints

Business context, monthly summaries, and quarterly tax data via /context, /monthly, /quarterly.

VeriFactu-safe delete

Soft delete for non-draft invoices and quotes. Full audit trail for Spanish tax compliance.

Endpoints

Method	Path	Description
GET	/v1/invoices	List invoices
POST	/v1/invoices	Create invoice
PATCH	/v1/invoices/:id	Update invoice
DELETE	/v1/invoices/:id	Delete invoice
POST	/v1/invoices/batch	Batch create invoices
GET	/v1/clients	List clients
POST	/v1/clients	Create client
GET	/v1/expenses	List expenses
POST	/v1/expenses	Create expense
GET	/v1/products	List products
GET	/v1/quotes	List quotes
GET	/v1/context	Business context
GET	/v1/monthly	Monthly summary
GET	/v1/quarterly	Quarterly taxes
GET	/openapi.yaml	OpenAPI specification

Code examples

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']

Authentication

Generate API keys from Settings > API in your Frihet dashboard. Include your key as a Bearer token in the Authorization header.

Authorization: Bearer fri_...

Full API documentation MCP Server

Start integrating today

API access included in all plans. Your API key is ready in Settings.

Start Free