Hent ejerlav
Registret over ejerlav (matrikulære distrikter), side for side og sorteret efter kode.
https://api.grundfast.dk/v1/ejerlavErstatter 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"{
"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
ejerlavkodepå/v1/jordstykker. ejerlav[].navnstring | null- Ejerlavets navn, fx "Vestervold Kvarter, København".
totalinteger- Antal ejerlav i hele registret.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-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.
{
"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
Bruges ofte sammen med
- GETAutocomplete på ejerlav
/v1/ejerlav /autocomplete - GETSlå et ejerlav op
/v1/ejerlav /:kode - GETSlå et jordstykke op
/v1/jordstykker
Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.