Adresser

Søg og list adgangsadresser

Søg efter adresser. Returnerer de adresser som opfylder kriteriet. Med mindre der er behov for felter som kun er med i den fulde adressestruktur anbefaler vi at, man tilføjer parameteren struktur=mini, da dette vil resultere i bedre performance.

GET/adgangsadresser

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Parametre

idstringquery

Adgangsadressens unikke id, f.eks. 0a3f5095-45ec-32b8-e044-0003ba298018.

statusintegerquery

Find adresser med den angivne status. "1" angiver en endelig adresse og "3" angiver en foreløbig adresse". Adresser med status "2" eller "4" er ikke med i DAWA.

vejkodeintegerquery

Vejkoden. 4 cifre.

vejnavnstringquery

Vejnavn. Der skelnes mellem store og små bogstaver.

husnrstringquery

Husnummer. Max 3 cifre eventuelt med et efterfølgende bogstav.

supplerendebynavnstringquery

Det supplerende bynavn.

postnrintegerquery

Postnummer. 4 cifre.

kommunekodeintegerquery

Kommunekoden for den kommune som adressen skal ligge på. 4 cifre.

Vis alle 51 parametreVis færre

regionskodeintegerquery

Find de adresser som ligger indenfor regionen angivet ved regionkoden.

sognekodeintegerquery

Find de adresser som ligger indenfor sognet angivet ved sognkoden.

retskredskodeintegerquery

Find de adresser som ligger indenfor retskredsen angivet ved retskredskoden.

politikredskodeintegerquery

Find de adresser som ligger indenfor politikredsen angivet ved politikredskoden.

opstillingskredskodeintegerquery

Find de adresser som ligger indenfor opstillingskredsen angivet ved opstillingskredskoden.

esrejendomsnrintegerquery

ESR Ejendomsnummer. Indtil 7 cifre. Søger på esrejendomsnummeret for det tilknyttede jordstykke.

nøjagtighedstringquery

Find adresser hvor adgangspunktet har en den angivne nøjagtighed. Mulige værdier er "A", "B" og "U"

stedidstringquery

Find de adresser som ligger indenfor stedet med den angivne ID

stednavnidstringquery

Deprecated, anvend stedid parameteren i stedet. Find de adresser som ligger indenfor stedet med den angivne ID

bebyggelsesidstringquery

Find de adresser som ligger indenfor bebyggelsen med den angivne ID

bebyggelsestypestringquery

Find de adresser som ligger en bebyggelse af den angivne type. Mulige værdier: "by", "bydel", "spredtBebyggelse", "sommerhusområde", "sommerhusområdedel", "industriområde", "kolonihave", "storby".

ejerlavkodeintegerquery

Koden på det matrikulære ejerlav som adressen skal ligge på.

matrikelnrstringquery

Matrikelnummer. Unikt indenfor et ejerlav.

afstemningsområdenummerintegerquery

Find de adresser som ligger i et afstemningsområde med det angivne nummer. Kombineres som regel med kommunekodeparameteren.

storkredsnummerintegerquery

Find de adresser som ligger storkredsen med det angivne nummer.

valglandsdelsbogstavstringquery

Find de adresser som ligger i den angivne valglandsdel.

zonestringquery

Adressens zonestatus. Mulige værdier: "Byzone", "Sommerhusområde" eller "Landzone"

zonekodeintegerquery

Heltalskoden for den zone som adressen skal ligge i. Mulige værdier er 1 for byzone, 2 for landzone og 3 for sommerhusområde.

adgangspunktidstringquery

Find adressen med det angivne adgangspunkt ID

vejpunkt_idstringquery

Find adressen med det angivne vejpunkt ID

navngivenvej_idstringquery

Find adresser på den navngivne vej med det angivne ID

landsdelsnuts3stringquery

Find adresser i landsdelen med den angivne NUTS3 kode.

husnrfrastringquery

Returner kun adresser hvor husnr er større eller lig det angivne.

husnrtilstringquery

Returner kun adresser hvor husnr er mindre eller lig det angivne. Bemærk, at hvis der angives f.eks. husnrtil=20, så er 20A ikke med i resultatet.

medtagugyldigestringquery

Medtag ugyldige adresser i svaret (adresser uden vejnavn, postnummer eller husnummer).

medtagnedlagtestringquery

Medtag nedlagte eller henlagte adresser i svaret.

qstringquery

Søgetekst. Der søges i vejnavn, husnr, supplerende bynavn, postnr og postnummerets navn. Alle ord i søgeteksten skal matche adgangsadressen. Wildcard * er tilladt i slutningen af hvert ord. Der skelnes ikke mellem store og små bogstaver. Der returneres højst 1000 resultater ved anvendelse af parameteren. Parameteren "fuzzy" kan tilføjes for at lave fuzzy søgning. Hvis behovet er at fremsøge en enkelt adresse ud fra en adressetekst, så vil det i de fleste tilfælde være bedre at benytte datavask API'et.

autocompletestringquery

Udfør søgning som autocomplete-søgning.

sridintegerquery

Angiver [SRID](http://en.wikipedia.org/wiki/SRID) for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84 / Geografiske koordinater). For ETRS89 / UTM zone 32 Nord anvender du 25832

strukturstringquery

Angiver om der ønskes en fuld svarstruktur (nestet), en flad svarstruktur (flad) eller en reduceret svarstruktur (mini). Mulige værdier: "nestet", "flad" eller "mini". For JSON er default "nestet", og for CSV og GeoJSON er default "flad". Det anbefales at benytte mini-formatet hvis der ikke er behov for den fulde struktur, da dette vil give bedre svartider.

polygonstringquery

Find de adresser, som ligger indenfor det angivne polygon. Polygonet specificeres som et array af koordinater på samme måde som koordinaterne specificeres i GeoJSON's [polygon](http://geojson.org/geojson-spec.html#polygon). Bemærk at polygoner skal være lukkede, dvs. at første og sidste koordinat skal være identisk. Som koordinatsystem kan anvendes (ETRS89/UTM32 eller) WGS84/geografisk. Dette angives vha. srid parameteren, se ovenover. Eksempel: polygon=[[[10.3,55.3],[10.4,55.3],[10.4,55.31],[10.4,55.31],[10.3,55.3]]].

cirkelstringquery

Find de adresser, som ligger indenfor den cirkel angivet af koordinatet (x,y) og radius r. Som koordinatsystem kan anvendes (ETRS89/UTM32 eller) WGS84/geografisk. Radius angives i meter. cirkel={x},{y},{r}.

fuzzystringquery

Aktiver fuzzy søgning

stednavnafstandnumberquery

Deprecated, anvend stedafstand parameteren i stedet. Anvendes sammen med stedid. Find de adresser, hvor afstanden til stedet angivet ved stedid er mindre end den angivne værdi. Afstanden angives i meter.

stedafstandnumberquery

Anvendes sammen med stedid. Find de adresser, hvor afstanden til stedet angivet ved stedid er mindre end den angivne værdi. Afstanden angives i meter.

kvhstringquery

KVH-nøgle. 12 tegn bestående af 4 cifre der repræsenterer kommunekode, 4 cifre der repræsenterer vejkode efterfulgt af 4 tegn der repræsenter husnr. Se databeskrivelse.

geometristringquery

Hvis GeoJSON formatet anvendes, angiver parameteren om det er adgangspunktet eller vejpunktet der anvendes. Mulige værdier: "adgangspunkt" eller "vejpunkt"

formatstringquery

Output leveres i andet format end *JSON*. Se Dataformater.

callbackstringquery

Output leveres i *JSONP* format. Se Dataformater.

noformatstringquery

Parameteren angiver, at whitespaceformatering skal udelades

ndjsonstringquery

Output leveres i [Newline Delimited JSON](http://ndjson.org)

sideintegerquery

Angiver hvilken siden som skal leveres. Se Paginering.

per_sideintegerquery

Antal resultater per side. Se Paginering.

Kald

curl --request GET \
  --url "https://api.danskadresseapi.dk/dawa/adgangsadresser" \
  --header "Authorization: Bearer $API_NOEGLE"

Svar

application/json

Success response. Responsets MIME type afhænger af format parameteren.

idstring<uuid>

Universel, unik identifikation af adressen.

kvhstring

Sammensat nøgle med kommunekode, vejkode og husnummer — til integration med ældre systemer.

DDKNobject

Adressens placering i Det Danske Kvadratnet, med celler på 100 m, 1 km og 10 km.

hrefstring

Adgangsadressens URL.

sognobject

Sognet adressen ligger i, beregnet fra adgangspunktet.

zonestring

Zonen adressen ligger i — byzone, landzone eller sommerhusområde.

husnrstring

Husnummer der identificerer adressen blandt andre med samme vejnavn.

regionobject

Regionen adressen ligger i, beregnet fra adgangspunktet.

Vis alle 34 felterVis færre

statusinteger

Adgangsadressens status. 1: gældende, 2: nedlagt, 3: foreløbig, 4: henlagt.

brofastboolean

Angiver om adressen er brofast — altså kan nås ad vej uden færge.

ejerlavobject

FORÆLDET — det matrikulære ejerlav hvor adressen tidligere var registreret. Brug jordstykke.ejerlav i stedet.

kommuneobject

Kommunen som adressen er beliggende i.

historikobject

Væsentlige tidspunkter: oprettet, ændret, ikrafttrædelse, nedlagt.

landsdelobject

Den landsdel adressen ligger i, beregnet fra adgangspunktet.

vejpunktobject

Geografisk punkt på færdselsnettet — startpunktet for ruten til adgangspunktet.

darstatusinteger

Status angivet ved statuskode i DAR. 2=foreløbig, 3=gældende, 4=nedlagt, 5=henlagt.

retskredsobject

Retskredsen adressen ligger i, beregnet fra adgangspunktet.

storkredsobject

Den storkreds adressen er beliggende i.

vejstykkeobject

Vejstykket som adressen er knyttet til.

jordstykkeobject

Jordstykket som adressens adgangspunkt ligger på.

matrikelnrstring

Matrikelnummer for det jordstykke adressen ligger på.

postnummerobject

Postnummeret som adressen er beliggende i.

bebyggelserobject[]

De bebyggelser adressen ligger indenfor, med id, href, kode, type og navn.

politikredsobject

Politikredsen adressen ligger i, beregnet fra adgangspunktet.

adgangspunktobject

Geografisk punkt som angiver særskilt adgang fra navngiven vej ind på areal eller bygning.

navngivenvejobject

Den navngivne vej som adgangsadressen er placeret på.

valglandsdelobject

Den valglandsdel adressen er beliggende i.

esrejendomsnrstring

Identifikation af vurderingsejendom jf. Ejendomsstamregisteret (ESR).

opstillingskredsobject

Opstillingskredsen adressen ligger i, beregnet fra adgangspunktet.

adressebetegnelsestring

Adressen på formen vej husnr, supplerende bynavn, postnr postnrnavn.

supplerendebynavnstring

Et supplerende bynavn — typisk landsbyens navn eller et andet lokalt stednavn.

afstemningsområdeobject

Afstemningsområdet adressen ligger i.

supplerendebynavn2object

Det supplerende bynavn som adgangsadressen ligger i, som objekt med id og navn.

stormodtagerpostnummerobject | null

Evt. stormodtagerpostnummer (firmapostnummer) tilknyttet adressen.

200Eksempel

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "kvh": "…",
    "DDKN": {},
    "href": "…",
    "sogn": {},
    "zone": "…",
    "husnr": "…",
    "region": {},
    "status": 0,
    "brofast": false,
    "ejerlav": {},
    "kommune": {}
  }
]

401Manglende nøgle

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}