Spring til indhold

List områder i et tema

Alle områder i én administrativ inddeling som kode og navn, fx de 99 kommuner.

GET/v1/dagi/{tema}

Svaret er en ren kodeliste — kode og navn for hvert område — uden geometri. Den kommer fra det medfølgende register, så kaldet afhænger ikke af Datafordeler og svarer også, når kilden er nede.

Koderne er DAGI’s egne, nulpolstrede strenge (0751 for Aarhus Kommune, 1084 for Region Hovedstaden). Brug dem direkte i /v1/dagi/:tema/:kode.

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.

Eksempel

curl "https://api.grundfast.dk/v1/dagi/kommune" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "tema": "kommune",
  "antal": 99,
  "omraader": [
    {
      "kode": "0101",
      "navn": "København"
    },
    {
      "kode": "0147",
      "navn": "Frederiksberg"
    },
    {
      "kode": "0151",
      "navn": "Ballerup"
    },
    {
      "kode": "0153",
      "navn": "Brøndby"
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAGI via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

temastringstipåkrævet
Den administrative inddeling, der skal listes.Værdier:regionkommunesognretskredspolitikredsopstillingskredsEksempel: kommune

Felter i svaret

temastring
Det tema, der blev spurgt om.
antalinteger
Antal områder i listen.
omraader[].kodestring
Områdets DAGI-kode som streng, fx 0751. Behandl den som tekst — foranstillede nuller betyder noget.
omraader[].navnstring
Områdets navn, fx "Aarhus".

Statuskoder

StatusBetydning
200Svaret er leveret.
400tema er ikke et af de seks kendte temaer.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/dagi/kommune

Bruges ofte sammen med

Læs mere om DAGI, og hvad data kan bruges til, på produktsiden.