Slå en adresse op

Én DAR-adresse ud fra dens UUID, struktureret i vejnavn, husnummer, etage, dør og postnummer med et WGS84-punkt.

GEThttps://api.grundfast.dk/v1/adresse/{uuid}

Opslaget går live mod DAR hos Datafordeler. UUID’en kan være en enhedsadresse (med etage og dør) eller en adgangsadresse (husnummer) — fx adgangsadresse_id fra søgningen eller adresse.id på en enhed i BBR-ejendommen. For en adgangsadresse er etage og doer null.

Kun gældende adresser returneres. Med asOf får du adressen, som den var registreret på en given dato; datoen ekkoes i meta.as_of. Er DAR nede, og findes der en cachet kopi, svarer endpointet med den og sætter headeren X-Grundfast-Stale: 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/adresse/0a3f50c2-09e9-32b8-e044-0003ba298018" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · fra demo-endpointet200json

{
  "adresse": {
    "id": "0a3f50c2-09e9-32b8-e044-0003ba298018",
    "betegnelse": "Solbakkevej 70, 8600 Silkeborg",
    "vejnavn": "Solbakkevej",
    "husnr": "70",
    "etage": "",
    "doer": "",
    "postnr": "8600",
    "postnrnavn": "Silkeborg",
    "kommunekode": "0740",
    "koordinat": { "lon": 9.532961, "lat": 56.1578452 }
  },
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

uuidstring (UUID)stipåkrævet: DAR-id (id_lokalId) for en enhedsadresse eller en adgangsadresse.Eksempel: 0a3f50c2-09e9-32b8-e044-0003ba298018
asOfstring (ISO 8601)queryvalgfri: Hent adressen, som den var registreret på en dato, fx 2020-01-01. Skal ligge mellem 1990-01-01 og i dag. Kræver Scale-planen; uden parameteren er kaldet åbent for alle planer.

Felter i svaret

adresse.betegnelsestring | null: Hele adresselinjen. Etage skrives med punktum, fx "2. tv".
adresse.etagestring | null: Etagebetegnelse, fx st, 1 eller kl. null for en adgangsadresse.
adresse.doerstring | null: Dørbetegnelse, fx tv, th eller mf. null for en adgangsadresse.
adresse.kommunekodestring | null: Er i øjeblikket altid null på dette opslag. Brug søgningen eller jordstykket, hvis du skal bruge kommunen.
adresse.koordinat{ lon, lat } | null: Adressepunktet i WGS84. null hvis punktet ikke kunne hentes.
meta.as_ofstring: Kun med når du har sendt asOf: det tidspunkt, svaret gælder for.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	UUID’en har ikke formatet 8-4-4-4-12, eller `asOf` er ugyldig, før 1990 eller i fremtiden.
401	Nøglen mangler eller er ugyldig.
402	`asOf` er sendt, men planen er under Scale.
404	UUID’en svarer ikke til en gældende adresse — eller, med `asOf`, ikke til en adresse på den dato.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
502	Datafordeler svarede ikke, og der fandtes ingen cachet kopi.
503	DAR-kilden er ikke konfigureret i dette miljø.

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

Prøv det

Live-kald fra siden

Bruges ofte sammen med

Læs mere om Adresser (DAR), og hvad data kan bruges til, på produktsiden.

curl "https://api.grundfast.dk/v1/adresse/0a3f50c2-09e9-32b8-e044-0003ba298018" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · demo200json

{
  "adresse": {
    "id": "0a3f50c2-09e9-32b8-e044-0003ba298018",
    "betegnelse": "Solbakkevej 70, 8600 Silkeborg",
    "vejnavn": "Solbakkevej",
    "husnr": "70",
    "etage": "",
    "doer": "",
    "postnr": "8600",
    "postnrnavn": "Silkeborg",
    "kommunekode": "0740",
    "koordinat": { "lon": 9.532961, "lat": 56.1578452 }
  },
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}