Hopp til innhold

Frihets REST API

Programmatisk tilgang til fakturaer, kunder, utgifter, produkter og tilbud. Designet for integrasjoner som skalerer.

https://api.frihet.io/v1 v1 — 2026-03-18 OpenAPI 3.1 · 82 paths · 137 operations

Laget for utviklere

Delvise PATCH-oppdateringer

Oppdater bare feltene du trenger. Delvise skjemaer validert med Zod garanterer integritet.

Søk og filtre

Fulltekstsøk med parameter ?q=. Feltmapping per ressurs for presise resultater.

Batch-operasjoner

Opprett opptil 50 ressurser i en enkelt forespørsel. HTTP 207 multi-status svar.

Idempotensnøkler

Prøv forespørsler på nytt på en trygg måte med Idempotency-Key-headeren. Nøkler gjenkjennes i 24 timer.

Ratelimit-headers

X-RateLimit-Limit, Remaining og Reset i hvert svar. Planlegg deretter.

OpenAPI 3.1 spesifikasjon

Maskinlesbar spesifikasjon i /openapi.yaml. 16 paths, 18 schemas. Genererer SDKer automatisk.

Intelligens-endepunkter

Forretningskontekst, månedlige sammendrag og kvartalsvise skattedata via /context, /monthly, /quarterly.

Sikker sletting VeriFactu

Soft delete for ikke-kladde fakturaer og tilbud. Full sporbarhet for spansk skattesamsvar.

Endepunkter

Method Path
GET /v1/invoices
POST /v1/invoices
PATCH /v1/invoices/:id
DELETE /v1/invoices/:id
POST /v1/invoices/batch
GET /v1/clients
POST /v1/clients
GET /v1/expenses
POST /v1/expenses
GET /v1/products
GET /v1/quotes
GET /v1/context
GET /v1/monthly
GET /v1/quarterly
GET /openapi.yaml

Kodeeksempler

                import { Frihet } from '@frihet/sdk';

const apiKey = process.env.FRIHET_API_KEY;
if (!apiKey) throw new Error('Set FRIHET_API_KEY before running this example');
const frihet = new Frihet({ apiKey });

// Follow each page's nextCursor until all paid invoices have been read.
let cursor: string | undefined;
do {
  const page = await frihet.invoices.list({ status: 'paid', limit: 25, cursor });
  for (const invoice of page.data) {
    console.log(invoice.documentNumber, invoice.total);
  }
  cursor = page.nextCursor;
} while (cursor);
              

Autentisering

Generer API-nøkler fra Innstillinger > API i ditt Frihet-panel. Inkluder din nøkkel som Bearer token i Authorization-headeren.

Authorization: Bearer fri_...

Begynn å integrere i dag

API-tilgang inkludert i alle planer. Din API-nøkkel er klar i Innstillinger.

Start Gratis