Hent alle postnumre

Alle danske postnumre med distriktsnavn i ét svar.

GEThttps://api.grundfast.dk/v1/postnumre

Erstatter DAWA’s /postnumre. Listen udledes af adresserne i DAR og returneres samlet, sorteret efter nummer — der er ingen sideinddeling. Svaret er { antal, total, postnumre, meta } i stedet for et bart array, og hvert postnummer er { nr, navn, stormodtager }.

Stormodtager-postnumre er udfaset og er som standard ikke med, ligesom i DAWA. Med stormodtagere=true kommer de historiske koder med, markeret stormodtager: true.

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

Svar · eksempel, forkortet200json

{
  "antal": 1089,
  "total": 1089,
  "postnumre": [
    { "nr": "1050", "navn": "København K", "stormodtager": false },
    { "nr": "1051", "navn": "København K", "stormodtager": false },
    { "nr": "1052", "navn": "København K", "stormodtager": false }
  ],
  "meta": {
    "kilde": "Datafordeler DAR (postnumre) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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

Parametre

stormodtagerebooleanqueryvalgfri: Tag de historiske stormodtager-postnumre med. true, 1 eller en tom værdi slår det til.Standard:false

Felter i svaret

postnumre[].nrstring: Firecifret postnummer som streng, fx "8000".
postnumre[].navnstring | null: Distriktsnavnet, fx "Aarhus C".
postnumre[].stormodtagerboolean: true kun for de historiske stormodtager-koder, du har bedt om.

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`.

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

Svar · eksempel, forkortet200json

{
  "antal": 1089,
  "total": 1089,
  "postnumre": [
    { "nr": "1050", "navn": "København K", "stormodtager": false },
    { "nr": "1051", "navn": "København K", "stormodtager": false },
    { "nr": "1052", "navn": "København K", "stormodtager": false }
  ],
  "meta": {
    "kilde": "Datafordeler DAR (postnumre) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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