Spring til indhold

Grundfast

Adresser på en ejendom

Alle adgangsadresser på et BFE-nummer, sorteret efter husnummer.

GET/v1/adgangsadresser/bfe/{bfe}

Erstatter DAWA’s /adgangsadresser?bfenummer=. Brug det, når du har et BFE-nummer og skal vise en adresse — fx fordi BBR-ejendommen ikke har en enhedsadresse. Svaret er et objekt { bfe_nummer, antal, truncated, adresser } i stedet for et bart array.

Adresserne sorteres numerisk efter husnummer, så 23 kommer før 103. Et BFE, der ikke er dækket af adresseindekset, giver 200 med antal: 0 — ikke 404. Der returneres højst 200 adresser; truncated er true, hvis der er flere.

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/adgangsadresser/bfe/6033528" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "bfe_nummer": 6033528,
  "antal": 8,
  "truncated": false,
  "adresser": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 }
    },
    {
      "betegnelse": "Bag Rådhuset 2, 1550 København V",
      "adgangsadresse_id": "7973ccc7-4a44-4a66-8619-9c5de5e47a12",
      "bfe_nummer": 6033528,
      "vejnavn": "Bag Rådhuset",
      "husnr": "2",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5710209, "lat": 55.6749032 }
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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

Parametre

bfeintegerstipåkrævet
BFE-nummeret (Bestemt Fast Ejendom).Eksempel: 6033528
sridstringqueryvalgfri
Når den er sat, får hver adresse koordinater i det system: [lon, lat] for 4326, [x, y] i meter for 25832.Værdier:432625832
formatstringqueryvalgfri
geojson giver en FeatureCollection med ét punkt pr. adresse i stedet for JSON-objektet.Standard:jsonVærdier:jsongeojson

Felter i svaret

antalinteger
Antal adresser i adresser. 0 betyder, at BFE’et ikke har adresser i indekset endnu.
truncatedboolean
true når ejendommen har flere end de 200 adresser, der returneres.
adresser[]object[]
Samme felter som et hit fra /v1/adresse/search: UUID, betegnelse, vejnavn, husnummer, postnummer, kommunekode og koordinat.

Statuskoder

StatusBetydning
200Svaret er leveret.
400BFE-nummeret er ikke et positivt heltal inden for gyldigt interval.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
503Adresseindekset er ikke slået til eller endnu ikke indlæst 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

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/adgangsadresser/bfe/6033528

Bruges ofte sammen med

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