DanskAdresseAPIv1
Adresser

Søg og list adresser

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/adresser

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Parametre

idstringquery

Adressens 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 54 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.

etagestringquery

Etagebetegnelse. Hvis værdi angivet kan den antage følgende værdier: tal fra 1 til 99, st, kl, k2 op til k9.

dørstringquery

Dørbetegnelse. Tal fra 1 til 9999, små bogstaver samt tegnene / og -.

adgangsadresseidstringquery

Id på den til adressen tilknyttede adgangsadresse. UUID.

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, etage, dør, supplerende bynavn, postnr og postnummerets navn. Alle ord i søgeteksten skal matche adressebetegnelsen. 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

kvhxstringquery

KVHX-nøgle. 19 tegn bestående af 4 cifre der repræsenterer kommunekode, 4 cifre der repræsenterer vejkode, 4 tegn der repræsenter husnr, 3 tegn der repræsenterer etage og 4 tegn der repræsenter dør. Se databeskrivelse.

geometristringquery

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

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.

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/adresser" \
  --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.

dørstring | null

Dørbetegnelse: tal fra 1 til 9999, små bogstaver samt tegnene skråstreg og bindestreg.

hrefstring

Adressens unikke URL.

kvhxstring

Sammensat nøgle med kommunekode, vejkode, husnummer, etage og dør.

etagestring | null

Etagebetegnelse: tal fra 1 til 99, samt st, kl, k2 op til k99.

statusinteger

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

historikobject

Væsentlige tidspunkter for adressen.

darstatusinteger

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

adgangsadresseobject

Adressens adgangsadresse — hele objektet med samme felter som /adgangsadresser.

adressebetegnelsestring

Adressen på formen vej husnr, etage. dør, postnr postnrnavn.

200Eksempel
[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "dør": null,
    "href": "…",
    "kvhx": "…",
    "etage": null,
    "status": 0,
    "historik": {},
    "darstatus": 0,
    "adgangsadresse": {},
    "adressebetegnelse": "…"
  }
]
401Manglende nøgle
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}