← Oversigt

API-dokumentation

Autentificering

Alle /api/v1/*-kald kræver en API-nøgle i Authorization-headeren:

Authorization: Bearer eu_live_…

Du finder dine nøgler i dashboardet.

Rate limits

Hvert kald returnerer:

  • X-RateLimit-Limit: månedlig kvote
  • X-RateLimit-Remaining: tilbageværende kald i denne periode
  • Ved overskridelse returneres 429 med Retry-After

POST /api/v1/calculate

Beregn ejerudgift ud fra ejendoms- og grundværdi.

Request body

{
  "kommunekode": "0101",
  "ejendomsvaerdi": 4500000,
  "grundvaerdi": 1200000,
  "skatteaar": 2026
}

Response

{
  "kommune": { "kode": "0101", "navn": "København", "grundskyldspromille": 6.79 },
  "ejendomsvaerdiskat": { "skatAarlig": 18768, "skatMaanedlig": 1564, ... },
  "grundskyld": { "skatAarlig": 6518, "skatMaanedlig": 543, ... },
  "renovation": { "takstAarlig": 4200, "takstMaanedlig": 350 },
  "totalAarlig": 29486,
  "totalMaanedlig": 2457,
  "skatteaar": 2026
}

POST /api/v1/cost-by-address

Indtast en adresse — vi slår op i DAWA og Vurderingsportalen og returnerer hele beregningen.

Request body

{
  "adresse": "Nørrebrogade 12, 2200 København N",
  "skatteaar": 2026
}

skatteaar er valgfri og defaulter til indeværende år.

GET /api/v1/municipality/:code

Hent grundskyldspromille, renovationstakst og ejendomsværdiskat-satser for en kommune.

GET /api/v1/municipality/0101

GET /api/v1/property-valuation

Slå offentlig vurdering op via adresse eller adgangsadresseId.

GET /api/v1/property-valuation?adresse=Nørrebrogade%2012,%202200

Fejl

Standardiserede HTTP-koder:

  • 400 — manglende eller ugyldigt input
  • 401 — manglende, ugyldig eller tilbagekaldt API-nøgle
  • 402 — ingen aktiv plan eller udløbet abonnement
  • 404 — ressource ikke fundet (fx ukendt kommune eller adresse)
  • 429 — månedligt loft nået
  • 5xx — fejl hos os eller en upstream-kilde