Spring til indhold

Grundfast

Hent ejerlav

Registret over ejerlav (matrikulære distrikter), side for side og sorteret efter kode.

GET/v1/ejerlav

Erstatter DAWA’s /ejerlav med samme side/per_side. Hvert ejerlav er { kode, navn }, og svaret er { antal, total, ejerlav, meta } i stedet for et bart array.

Registret ligger i Grundfast selv og afhænger ikke af Datafordeler, så kaldet svarer også, når Datafordeler er nede.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald pr. side.

Eksempel

curl "https://api.grundfast.dk/v1/ejerlav?per_side=100" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet200
{
  "antal": 5,
  "total": 9033,
  "ejerlav": [
    { "kode": 10051, "navn": "Frederiksberg" },
    { "kode": 10151, "navn": "Gentofte" },
    { "kode": 10251, "navn": "Buddinge" },
    { "kode": 10252, "navn": "Gladsaxe" },
    { "kode": 10352, "navn": "Hellerup" }
  ],
  "meta": {
    "kilde": "Datafordeler Matriklen (ejerlav) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

per_sideintegerqueryvalgfri
Antal ejerlav pr. side, højst 100.Standard:100Eksempel: 100
sideintegerqueryvalgfri
Sidenummer, startende ved 1.Standard:1

Felter i svaret

ejerlav[].kodeinteger
Ejerlavskoden — den du bruger som ejerlavkode på /v1/jordstykker.
ejerlav[].navnstring | null
Ejerlavets navn, fx "Vestervold Kvarter, København".
totalinteger
Antal ejerlav i hele registret.

Statuskoder

StatusBetydning
200Svaret er leveret.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

Prøv det

Live-kald fra siden

Demoen svarer med de første 5 ejerlav i registret. per_side og side i formularen bruges ikke.

GET /v1/demo/ejerlav

Bruges ofte sammen med

Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.