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
}

Response

{
  "kommune": { "kode": "0101", "navn": "København", "grundskyldspromille": 5.1 },
  "ejendomsvaerdiskat": { "skatAarlig": 18360, "skatMaanedlig": 1530, ... },
  "grundskyld": { "skatAarlig": 4896, "skatMaanedlig": 408, ... },
  "renovation": { "takstAarlig": 2916, "takstMaanedlig": 243 },
  "husforsikring": { "aarlig": 6000, "maanedlig": 500, "estimat": true },
  "grundejerforening": { "aarlig": 3000, "maanedlig": 250, "estimat": true },
  "boligskatAarlig": 23256,
  "boligskatMaanedlig": 1938,
  "ejerudgiftAarlig": 35172,
  "ejerudgiftMaanedlig": 2931,
  "totalAarlig": 26172,
  "totalMaanedlig": 2181,
  "skatteaar": 2026
}

skatteaar er valgfri og defaulter til det gældende skatteår (2026). Tidligere år kan stadig angives.

ejerudgiftMaanedlig/ejerudgiftAarlig følger definitionen i salgsopstillingen (BEK 1413/2023 § 12): boligskat (ejendomsværdiskat + grundskyld) + renovation + husforsikring + grundejerforening. Husforsikring og grundejerforening er estimater (6.000 og 3.000 kr./år), som du kan erstatte med de valgfri felter husforsikringAarlig og grundejerforeningAarlig (fx 0). estimat er true, når standardværdien er brugt.

totalMaanedlig/totalAarlig (boligskat + renovation) er forældede og fjernes senere. Brug ejerudgift* eller boligskat*.

POST /api/v1/cost-by-address

Indtast en adresse. Vi slår op i Danmarks Adresseregister og Vurderingsportalen og returnerer hele beregningen.

Request body

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

skatteaar er valgfri og defaulter til det gældende skatteår (2026). Vi bruger vurderingen for året før skatteåret: den endelige, hvis den findes, ellers den forventede endelige eller den foreløbige. cost-by-address tager også husforsikringAarlig og grundejerforeningAarlig.

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. Returnerer vurderingen, der gælder for det aktuelle skatteår. vurderingstype er endelig, forventet (den endelige er ikke udsendt; beregnet ud fra en tidligere endelig vurdering) eller foreloebig.

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

Response

{
  "ejendomsvaerdi": 5804000,
  "grundvaerdi": 3941000,
  "vurderingsaar": "2024",
  "vurderingstype": "endelig",
  "adresse": "Holmager 7, 2970 Hørsholm",
  ...
}