Slå et postnummer op

Ét postnummer og dets distriktsnavn.

GEThttps://api.grundfast.dk/v1/postnumre/{nr}

Erstatter DAWA’s /postnumre/{nr}, men svaret er smallere: nr, navn og stormodtager plus meta. Opslaget finder også de historiske stormodtager-koder, selvom listen skjuler dem som standard.

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/postnumre/8000" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "nr": "8000",
  "navn": "Aarhus C",
  "stormodtager": false,
  "meta": {
    "kilde": "Datafordeler DAR (postnumre) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

nrstringstipåkrævet: Postnummeret — præcis 4 cifre.Eksempel: 8000

Felter i svaret

nrstring: Postnummeret som firecifret streng, fx "8000".
navnstring | null: Distriktsnavnet, fx "Aarhus C".
stormodtagerboolean: true for en historisk stormodtager-kode.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	`nr` er ikke præcis 4 cifre.
401	Nøglen mangler eller er ugyldig.
404	Postnummeret findes ikke.
429	Burst-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

Bruges ofte sammen med

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

curl "https://api.grundfast.dk/v1/postnumre/8000" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "nr": "8000",
  "navn": "Aarhus C",
  "stormodtager": false,
  "meta": {
    "kilde": "Datafordeler DAR (postnumre) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}