Adresser

API'et udstiller Danmarks adresser samt tilhørende funktionalitet.

Adressesøgning

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 https://api.dataforsyningen.dk/adresser

Parametre

Navn	Beskrivelse
`id`	Adressens unikke id, f.eks. 0a3f5095-45ec-32b8-e044-0003ba298018. (Flerværdisøgning mulig).
`autocomplete`	Udfør søgning som autocomplete-søgning.
`q`	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.
`fuzzy`	Aktiver fuzzy søgning
`adgangsadresseid`	Id på den til adressen tilknyttede adgangsadresse. UUID. (Flerværdisøgning mulig).
`etage`	Etagebetegnelse. Hvis værdi angivet kan den antage følgende værdier: tal fra 1 til 99, st, kl, k2 op til k9. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`dør`	Dørbetegnelse. Tal fra 1 til 9999, små bogstaver samt tegnene / og -. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`kvhx`	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.
`status`	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.
`vejkode`	Vejkoden. 4 cifre. (Flerværdisøgning mulig).
`vejnavn`	Vejnavn. Der skelnes mellem store og små bogstaver. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`husnr`	Husnummer. Max 3 cifre eventuelt med et efterfølgende bogstav. (Flerværdisøgning mulig).
`husnrfra`	Returner kun adresser hvor husnr er større eller lig det angivne.
`husnrtil`	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.
`supplerendebynavn`	Det supplerende bynavn. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`postnr`	Postnummer. 4 cifre. (Flerværdisøgning mulig).
`kommunekode`	Kommunekoden for den kommune som adressen skal ligge på. 4 cifre. (Flerværdisøgning mulig).
`ejerlavkode`	Koden på det matrikulære ejerlav som adressen skal ligge på.
`zonekode`	Bemærk. Zone er udfaset - læs mere her. Heltalskoden for den zone som adressen skal ligge i. Mulige værdier er 1 for byzone, 2 for landzone og 3 for sommerhusområde. (Flerværdisøgning mulig).
`zone`	Bemærk. Zone er udfaset - læs mere her. Adressens zonestatus. Mulige værdier: "Byzone", "Sommerhusområde" eller "Landzone" (Flerværdisøgning mulig).
`matrikelnr`	Matrikelnummer. Unikt indenfor et ejerlav.
`esrejendomsnr`	⚠ Bemærk! DAWA anvender tilbagekonverteret BBR-data, som ikke længere opdateres fra 16. december 2023. BBR-data udfases helt i DAWA pr. 1. april 2024. Læs mere her. Indtil 7 cifre. Søger på esrejendomsnummeret for det tilknyttede jordstykke. (Flerværdisøgning mulig).
`srid`	Angiver 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
`polygon`	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. 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]]].
`cirkel`	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}.
`nøjagtighed`	Find adresser hvor adgangspunktet har en den angivne nøjagtighed. Mulige værdier er "A", "B" og "U" (Flerværdisøgning mulig).
`regionskode`	Find de adresser som ligger indenfor regionen angivet ved regionkoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`landsdelsnuts3`	Find adresser i landsdelen med den angivne NUTS3 kode.
`sognekode`	Find de adresser som ligger indenfor sognet angivet ved sognkoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`afstemningsområdenummer`	Find de adresser som ligger i et afstemningsområde med det angivne nummer. Kombineres som regel med kommunekodeparameteren. (Flerværdisøgning mulig).
`opstillingskredskode`	Find de adresser som ligger indenfor opstillingskredsen angivet ved opstillingskredskoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`storkredsnummer`	Find de adresser som ligger storkredsen med det angivne nummer. (Flerværdisøgning mulig).
`valglandsdelsbogstav`	Find de adresser som ligger i den angivne valglandsdel. (Flerværdisøgning mulig).
`retskredskode`	Find de adresser som ligger indenfor retskredsen angivet ved retskredskoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`politikredskode`	Find de adresser som ligger indenfor politikredsen angivet ved politikredskoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`stednavnid`	Deprecated, anvend stedid parameteren i stedet. Find de adresser som ligger indenfor stedet med den angivne ID
`stedid`	Find de adresser som ligger indenfor stedet med den angivne ID
`stednavnafstand`	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.
`stedafstand`	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.
`bebyggelsesid`	Find de adresser som ligger indenfor bebyggelsen med den angivne ID (Flerværdisøgning mulig).
`bebyggelsestype`	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". (Flerværdisøgning mulig).
`adgangspunktid`	Find adressen med det angivne adgangspunkt ID
`vejpunkt_id`	Find adressen med det angivne vejpunkt ID
`navngivenvej_id`	Find adresser på den navngivne vej med det angivne ID
`geometri`	Hvis GeoJSON formatet anvendes, angiver parameteren om det er adgangspunktet eller vejpunktet der anvendes. Mulige værdier: "adgangspunkt" eller "vejpunkt"
`callback`	Output leveres i JSONP format. Se Dataformater.
`format`	Output leveres i andet format end JSON. Se Dataformater.
`noformat`	Parameteren angiver, at whitespaceformatering skal udelades
`ndjson`	Output leveres i Newline Delimited JSON
`side`	Angiver hvilken siden som skal leveres. Se Paginering.
`per_side`	Antal resultater per side. Se Paginering.
`struktur`	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.
`medtagugyldige`	Medtag ugyldige adresser i svaret (adresser uden vejnavn, postnummer eller husnummer).
`medtagnedlagte`	Medtag nedlagte eller henlagte adresser i svaret.

Eksempler

Find de adresser som ligger på Rødkildevej og har husnummeret 46.

https://api.dataforsyningen.dk/adresser?vejnavn=Rødkildevej&husnr=46&struktur=mini

Find de adresser som ligger på Rødkildevej og har husnummeret 46. Resultatet leveres i JSONP format.

https://api.dataforsyningen.dk/adresser?vejnavn=Rødkildevej&husnr=46&callback=cbFun

Find de adresser som ligger på Rødkildevej og har husnummeret 46. Resultatet leveres i geojson format.

https://api.dataforsyningen.dk/adresser?vejnavn=Rødkildevej&husnr=46&format=geojson&struktur=mini

Find de adresser som ligger på Rødkildevej og har husnummeret 46. Resultatet leveres i csv format.

https://api.dataforsyningen.dk/adresser?vejnavn=Rødkildevej&husnr=46&format=csv

Find de adresser som indeholder et ord der starter med hvid og har postnummeret 2400

https://api.dataforsyningen.dk/adresser?q=hvid*&postnr=2400

Find de adresser som er indenfor polygonet (10.3,55.3), (10.4,55.3), (10.4,55.31), (10.4,55.31), (10.3,55.3)

https://api.dataforsyningen.dk/adresser?polygon=[[[10.3,55.3],[10.4,55.3],[10.4,55.31],[10.4,55.31],[10.3,55.3]]]

Find den adresse, som har KVHX-nøgle 04615319__93__1____

https://api.dataforsyningen.dk/adresser?kvhx=04615319__93__1____

Hent alle adresse i postnummer 8471, i GeoJSON format, med koordinater angivet i ETRS89 / UTM zone 32 Nord (SRID 25832)

https://api.dataforsyningen.dk/adresser?postnr=8471&format=geojson&srid=25832

Adresseopslag

Modtag adresse med id.

GET https://api.dataforsyningen.dk/adresser/{id}

Parametre

Navn	Beskrivelse
`id`	Adressens unikke id, f.eks. 0a3f5095-45ec-32b8-e044-0003ba298018.
`struktur`	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.
`geometri`	Hvis GeoJSON formatet anvendes, angiver parameteren om det er adgangspunktet eller vejpunktet der anvendes. Mulige værdier: "adgangspunkt" eller "vejpunkt"
`medtagugyldige`	Medtag ugyldige adresser i svaret (adresser uden vejnavn, postnummer eller husnummer).
`medtagnedlagte`	Medtag nedlagte eller henlagte adresser i svaret.

Eksempler

Returner adressen med id 000021c5-e9ee-411d-b2d8-ec9161780ccd

https://api.dataforsyningen.dk/adresser/000021c5-e9ee-411d-b2d8-ec9161780ccd

Adresse autocomplete

Autocomplete af adresser. Der kan anvendes de samme parametre som ved søgning, men bemærk at q parameteren fortolkes anderledes. Læs mere under autocomplete. DAWA tilbyder en kombineret autocomplete, som giver en bedre brugeroplevelse end autocomplete direkte i adresser.

GET https://api.dataforsyningen.dk/adresser/autocomplete

Parametre

Navn	Beskrivelse
`id`	Adressens unikke id, f.eks. 0a3f5095-45ec-32b8-e044-0003ba298018. (Flerværdisøgning mulig).
`autocomplete`	Udfør søgning som autocomplete-søgning.
`q`	Se beskrivelse under autocomplete
`fuzzy`	Aktiver fuzzy søgning
`adgangsadresseid`	Id på den til adressen tilknyttede adgangsadresse. UUID. (Flerværdisøgning mulig).
`etage`	Etagebetegnelse. Hvis værdi angivet kan den antage følgende værdier: tal fra 1 til 99, st, kl, k2 op til k9. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`dør`	Dørbetegnelse. Tal fra 1 til 9999, små bogstaver samt tegnene / og -. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`kvhx`	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.
`status`	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.
`vejkode`	Vejkoden. 4 cifre. (Flerværdisøgning mulig).
`vejnavn`	Vejnavn. Der skelnes mellem store og små bogstaver. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`husnr`	Husnummer. Max 3 cifre eventuelt med et efterfølgende bogstav. (Flerværdisøgning mulig).
`husnrfra`	Returner kun adresser hvor husnr er større eller lig det angivne.
`husnrtil`	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.
`supplerendebynavn`	Det supplerende bynavn. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`postnr`	Postnummer. 4 cifre. (Flerværdisøgning mulig).
`kommunekode`	Kommunekoden for den kommune som adressen skal ligge på. 4 cifre. (Flerværdisøgning mulig).
`ejerlavkode`	Koden på det matrikulære ejerlav som adressen skal ligge på.
`zonekode`	Bemærk. Zone er udfaset - læs mere her. Heltalskoden for den zone som adressen skal ligge i. Mulige værdier er 1 for byzone, 2 for landzone og 3 for sommerhusområde. (Flerværdisøgning mulig).
`zone`	Bemærk. Zone er udfaset - læs mere her. Adressens zonestatus. Mulige værdier: "Byzone", "Sommerhusområde" eller "Landzone" (Flerværdisøgning mulig).
`matrikelnr`	Matrikelnummer. Unikt indenfor et ejerlav.
`esrejendomsnr`	⚠ Bemærk! DAWA anvender tilbagekonverteret BBR-data, som ikke længere opdateres fra 16. december 2023. BBR-data udfases helt i DAWA pr. 1. april 2024. Læs mere her. Indtil 7 cifre. Søger på esrejendomsnummeret for det tilknyttede jordstykke. (Flerværdisøgning mulig).
`srid`	Angiver 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
`polygon`	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. 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]]].
`cirkel`	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}.
`nøjagtighed`	Find adresser hvor adgangspunktet har en den angivne nøjagtighed. Mulige værdier er "A", "B" og "U" (Flerværdisøgning mulig).
`regionskode`	Find de adresser som ligger indenfor regionen angivet ved regionkoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`landsdelsnuts3`	Find adresser i landsdelen med den angivne NUTS3 kode.
`sognekode`	Find de adresser som ligger indenfor sognet angivet ved sognkoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`afstemningsområdenummer`	Find de adresser som ligger i et afstemningsområde med det angivne nummer. Kombineres som regel med kommunekodeparameteren. (Flerværdisøgning mulig).
`opstillingskredskode`	Find de adresser som ligger indenfor opstillingskredsen angivet ved opstillingskredskoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`storkredsnummer`	Find de adresser som ligger storkredsen med det angivne nummer. (Flerværdisøgning mulig).
`valglandsdelsbogstav`	Find de adresser som ligger i den angivne valglandsdel. (Flerværdisøgning mulig).
`retskredskode`	Find de adresser som ligger indenfor retskredsen angivet ved retskredskoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`politikredskode`	Find de adresser som ligger indenfor politikredsen angivet ved politikredskoden. (Flerværdisøgning mulig). Søgning efter ingen værdi mulig.
`stednavnid`	Deprecated, anvend stedid parameteren i stedet. Find de adresser som ligger indenfor stedet med den angivne ID
`stedid`	Find de adresser som ligger indenfor stedet med den angivne ID
`stednavnafstand`	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.
`stedafstand`	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.
`bebyggelsesid`	Find de adresser som ligger indenfor bebyggelsen med den angivne ID (Flerværdisøgning mulig).
`bebyggelsestype`	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". (Flerværdisøgning mulig).
`adgangspunktid`	Find adressen med det angivne adgangspunkt ID
`vejpunkt_id`	Find adressen med det angivne vejpunkt ID
`navngivenvej_id`	Find adresser på den navngivne vej med det angivne ID
`geometri`	Hvis GeoJSON formatet anvendes, angiver parameteren om det er adgangspunktet eller vejpunktet der anvendes. Mulige værdier: "adgangspunkt" eller "vejpunkt"
`medtagugyldige`	Medtag ugyldige adresser i svaret (adresser uden vejnavn, postnummer eller husnummer).
`medtagnedlagte`	Medtag nedlagte eller henlagte adresser i svaret.
`callback`	Output leveres i JSONP format. Se Dataformater.
`format`	Output leveres i andet format end JSON. Se Dataformater.
`noformat`	Parameteren angiver, at whitespaceformatering skal udelades
`ndjson`	Output leveres i Newline Delimited JSON
`side`	Angiver hvilken siden som skal leveres. Se Paginering.
`per_side`	Antal resultater per side. Se Paginering.

Eksempler

Find alle adresser som indeholder rand

https://api.dataforsyningen.dk/adresser/autocomplete?q=rand

Find alle adresser som indeholder randers på postnr 8450

https://api.dataforsyningen.dk/adresser/autocomplete?q=randers&postnr=8450

Beskrivelse af adressedata

En adresse er en struktureret betegnelse som angiver en særskilt adgang til et areal, en bygning eller en del af en bygning efter reglerne i adressebekendtgørelsen.

En adresse angiver en særskilt adgang til et areal, en bygning eller en del af en bygning, efter reglerne i adressebekendtgørelsen. En adresse fastsættes for at angive en bestemt adgang til:

et areal, fx. en byggegrund, et grønt område eller en sportsplads
en bygning, herunder et andet bygværk, f.eks. et teknisk anlæg
en del af en bygning, fx en etage eller en bolig- eller erhvervs¬enhed i en bygning

Forskellen på en adresse og en adgangsadresse er at adressen rummer eventuel etage- og/eller dørbetegnelse. Det gør adgangsadressen ikke.

Web API'et udstiller for hver adresse følgende informationer:

Navn				Type	Optionelt	Beskrivelse
href				string	nej	Adressens unikke URL.
id				string	nej	Universel, unik identifikation af adressen af datatypen UUID. Er stabil over hele adressens levetid (ligesom et CPR-nummer) dvs. uanset om adressen evt. ændrer vejnavn, husnummer, postnummer eller kommunekode. Repræsenteret som 32 hexadecimale tegn. Eksempel: ”0a3f507a-93e7-32b8-e044-0003ba298018”.
kvhx				string	nej	Sammensat nøgle for adressen. Indeholder til brug for integration til ældre systemer felter, der tilsammen identificerer adressen. Hvis det er muligt, bør adressens id eller href benyttes til identifikation. KVHX-nøglen er sammen således: Index 0-3: Kommunekode Kommunekode for adressen. Hvis kommunekoden har mindre end 4 cifre, foranstilles med nuller, kommunekode 175 repræsenteres altså fx som "0175". Hvis en adresse ikke har et tilknyttet kommunenr er værdien "0000" Index 4-7: Vejstykkekode Kode for adressens vejstykke. Hvis vejstykkets kode har mindre end 4 cifre, foranstilles med nuller, vejstykkekode 370 repræsenteres altså fx som "0370". Index 8-11: Husnr Adressens husnr (inklusive evt. bogstav). Hvis husnummeret har mindre end 4 cifre, foranstilles med underscores, 1C repræsenteres altså fx som ‘__1C’. Husnumre uden bogstav repræsenteres blot med foranstillede underscores, så fx 17 repræsenteres som "__17". Index 12-14: Etage Adressens etage. Hvis etageangivelsen fylder mindre end 3 tegn, foranstilles med underscore, ‘st’ repræsenteres altså som "_st" Index 15-18: Dør Angivelse af dør. Hvis dørbetegnelsen fylder mindre end 4 tegn, foranstilles med underscore, 2 repræsenteres altså som "___2" En adresse på vejstykke 1074 (Melvej) 6, st. tv i kommune 420 (Assens) vil altså få KVH-nøgle "04201074___6_st__tv"
status				integer	nej	Adressens status. Heltal. Mulige værdier er 1: gældende, 2: nedlagt, 3: foreløbig, 4: henlagt.
darstatus				integer	nej	Aadressens status angivet ved statuskode i DAR. 2=Føreløbig, 3=Gældende, 4=Nedlagt, 5=Henlagt
etage				string	ja	Etagebetegnelse. Hvis værdi angivet kan den antage følgende værdier: tal fra 1 til 99, st, kl, k2 op til k99.
dør				string	ja	Dørbetegnelse. Hvis værdi angivet kan den antage følgende værdier: tal fra 1 til 9999, små bogstaver samt tegnene / og -.
adressebetegnelse				string	nej
historik				object	nej	Væsentlige tidspunkter for adressen
	oprettet			string	nej	Dato og tid for adressens oprettelse, som registreret hos DAR. Eksempel: 2001-12-23T00:00:00.
	ændret			string	nej	Dato og tid hvor der sidst er ændret i adressen, som registreret hos DAR. Eksempel: 2002-04-08T00:00:00.
	ikrafttrædelse			string	nej	Tidspunkt for adressens ikrafttrædelse, dvs. det tidspunkt hvor adressen har status "gældende". Kan være i fremtiden.
	nedlagt			string	nej	Tidspunkt for adressens nedlæggelse eller henlæggelse, dvs. det tidspunkt hvor adressen har status "nedlagt" eller "henlagt". Kan være i fremtiden.
adgangsadresse				object	nej	Adressens adgangsadresse
	href			string	nej	Adgangsadressens URL.
	id			string	nej	Universel, unik identifikation af adressen af datatypen UUID. Er stabil over hele adressens levetid (ligesom et CPR-nummer) dvs. uanset om adressen evt. ændrer vejnavn, husnummer, postnummer eller kommunekode. Repræsenteret som 32 hexadecimale tegn. Eksempel: ”0a3f507a-93e7-32b8-e044-0003ba298018”.
	adressebetegnelse			string	nej	Adgangsadressenbetegnelsen på formen {vej} {husnr}, {supplerende bynavn}, {postnr} {postnrnavn}
	kvh			string	nej	Sammensat nøgle for adgangsadressen. Indeholder til brug for integration til ældre systemer felter, der tilsammen identificerer adressen. Hvis det er muligt, bør adressens id eller href benyttes til identifikation. KVH-nøglen er sammen således: Index 0-3: Kommunekode Kommunekode for adressen. Hvis kommunekoden har mindre end 4 cifre, foranstilles med nuller, kommunekode 175 repræsenteres altså fx som "0175". Hvis en adresse ikke har et tilknyttet kommunenr er værdien "0000" Index 4-7: Vejstykkekode Kode for adressens vejstykke. Hvis vejstykkets kode har mindre end 4 cifre, foranstilles med nuller, vejstykkekode 370 repræsenteres altså fx som "0370". Index 8-11: Husnr Adressens husnr (inklusive evt. bogstav). Hvis husnummeret har mindre end 4 cifre, foranstilles med underscores, 1C repræsenteres altså fx som ‘__1C’. Husnumre uden bogstav repræsenteres blot med foranstillede underscores, så fx 17 repræsenteres som "__17". En adresse på vejstykke 1074 (Melvej) nummer 6 i kommune 420 (Assens) vil altså få KVH-nøgle "04201074___6"
	status			integer	nej	Adgangsadressens status. Heltal. Mulige værdier er 1: gældende, 2: nedlagt, 3: foreløbig, 4: henlagt.
	darstatus			integer	nej	Adgangsadressens status angivet ved statuskode i DAR. 2=Føreløbig, 3=Gældende, 4=Nedlagt, 5=Henlagt
	vejstykke			object	nej	Vejstykket som adressen er knyttet til.
		href		string	nej	Vejstykkets unikke URL.
		kode		string	nej	Identifikation af vejstykket. Er unikt indenfor den pågældende kommune. Repræsenteret ved fire cifre. Eksempel: I Københavns kommune er ”0004” lig ”Abel Cathrines Gade”.
		navn		string	ja	Vejens navn.
		adresseringsnavn		string	ja	En evt. forkortet udgave af vejnavnet på højst 20 tegn, som bruges ved adressering på labels og rudekuverter og lign., hvor der ikke plads til det fulde vejnavn.
	husnr			string	ja	Husnummer der identificerer den pågældende adresse i forhold til andre adresser med samme vejnavn. Husnummeret består af et tal 1-999 evt. suppleret af et stort bogstav A..Z, og fastsættes i stigende orden, normalt med lige og ulige numre på hver side af vejen. Eksempel: "11", "12A", "187B".
	navngivenvej			object	nej	Den navngivne vej, som adgangsadressen er placeret på
		href		string	nej	Den navngivne vejs URL
		id		string	nej	Den navngivne vejs ID
	supplerendebynavn			string	ja	Et supplerende bynavn – typisk landsbyens navn – eller andet lokalt stednavn, der er fastsat af kommunen for at præcisere adressens beliggenhed indenfor postnummeret. Indgår som en del af den officielle adressebetegnelse. Indtil 34 tegn. Eksempel: ”Sønderholm”.
	supplerendebynavn2			object	ja	Det supplerende bynavn, som adgangsadressen ligger i
		href		string	nej	Det supplerende bynavns unikke URL
		dagi_id		string	nej	Det supplerende bynavns unikke ID i DAGI
	postnummer			object	ja	Postnummeret som adressen er beliggende i.
		href		string	nej	Postnummerets unikke URL
		nr		string	nej	Postnummer
		navn		string	ja	Det navn der er knyttet til postnummeret, typisk byens eller bydelens navn. Repræsenteret ved indtil 20 tegn. Eksempel: ”København NV”.
	stormodtagerpostnummer			object	ja	Evt. stormodtagerpostnummer (firmapostnummer) som er tilknyttet adressen.
		href		string	nej	Postnummerets unikke URL
		nr		string	nej	Postnummer
		navn		string	ja	Det navn der er knyttet til postnummeret, typisk byens eller bydelens navn. Repræsenteret ved indtil 20 tegn. Eksempel: ”København NV”.
	kommune			object	nej	Kommunen som adressen er beliggende i.
		href		string	nej	Kommunens unikke URL.
		kode		string	nej	Kommunekoden. 4 cifre.
		navn		string	ja	Kommunens navn.
	ejerlav			object	ja	DEPRECATED. Opdateres ikke længere. Benyt "jordstykke" i stedet. Feltet indeholder den værdi der i sin tid var registreret i BBR. I dag beregnes det tilhørende jordstykke ud fra adgangspunktets placering.
		kode		integer	ja	Ejerlavkode for det jordstykke, som adressen er placeret på. Repræsenteret ved indtil 7 cifre. Eksempel: ”170354” for ejerlavet ”Eskebjerg By, Bregninge”.
		navn		string	nej	Det matrikulære ”ejerlav”s navn. Eksempel: ”Eskebjerg By, Bregninge”.
	matrikelnr			string	ja	Matrikelnummer for det jordstykke, som adressen er placeret på. Repræsenteret ved Indtil 7 tegn: max. 4 cifre + max. 3 små bogstaver. Eksempel: ”18b”.
	esrejendomsnr			string	ja	⚠ Bemærk: DAWA anvender tilbagekonverteret BBR-data, som ikke længere opdateres fra 16. december 2023. BBR-data udfases helt i DAWA pr. 1. april 2024. Læs mere på https://dataforsyningen.dk/news/4915. Identifikation af den vurderingsejendom jf. Ejendomsstamregisteret, ESR, som det jordstykke som adressen ligger på, er en del af. Repræsenteret ved op til syv cifre. Eksempel ”13606”.
	historik			object	nej	Væsentlige tidspunkter for adgangsadressen
		oprettet		string	ja	Dato og tid for adgangsadressens oprettelse, som registreret i DAR. Eksempel: 2001-12-23T00:00:00.
		ændret		string	ja	Dato og tid hvor der sidst er ændret i adgangsadressen, som registreret i DAR. Eksempel: 2002-04-08T00:00:00.
		ikrafttrædelse		string	nej	Tidspunkt for adgangsadressens ikrafttrædelse, dvs. det tidspunkt hvor adgangsadressen har status "gældende". Kan være i fremtiden.
		nedlagt		string	nej	Tidspunkt for adgangsadressens nedlæggelse eller henlæggelse, dvs. det tidspunkt hvor adgangsadressen har status "nedlagt" eller "henlagt". Kan være i fremtiden.
	adgangspunkt			object	nej	Geografisk punkt, som angiver særskilt adgang fra navngiven vej ind på et areal eller bygning.
		id		string	ja	Adgangspunktets unikke ID
		koordinater		array	ja	Adgangspunktets koordinater som array [x,y].
			item	number	nej	koordinat for punktet.
		højde		number	ja	Højden (koten) er beregnet efter Dansk Vertikal Reference 1990 (DVR90) fra middelvandstanden i havene ved Danmarks kyster til terrænniveau. Angivet i meter. Beregnet ud fra den danske højdemodel. Værdien -9999 angiver, at adressens adgangspunkt er udenfor højdemodellen, og derfor ikke kan beregnes.
		nøjagtighed		string	nej	Kode der angiver nøjagtigheden for adressepunktet. Et tegn. ”A” betyder at adressepunktet er absolut placeret på et detaljeret grundkort, typisk med en nøjagtighed bedre end +/- 2 meter. ”B” betyder at adressepunktet er beregnet – typisk på basis af matrikelkortet, således at adressen ligger midt på det pågældende matrikelnummer. I så fald kan nøjagtigheden være ringere en end +/- 100 meter afhængig af forholdene. ”U” betyder intet adressepunkt.
		kilde		integer	ja	Kode der angiver kilden til adressepunktet. Et tegn. ”1” = oprettet maskinelt fra teknisk kort; ”2” = Oprettet maskinelt fra af matrikelnummer tyngdepunkt; ”3” = Eksternt indberettet af konsulent på vegne af kommunen; ”4” = Eksternt indberettet af kommunes kortkontor o.l. ”5” = Oprettet af teknisk forvaltning."
		tekniskstandard		string	ja	Kode der angiver den specifikation adressepunktet skal opfylde. 2 tegn. ”TD” = 3 meter inde i bygningen ved det sted hvor indgangsdør e.l. skønnes placeret; ”TK” = Udtrykkelig TK-standard: 3 meter inde i bygning, midt for længste side mod vej; ”TN” Alm. teknisk standard: bygningstyngdepunkt eller blot i bygning; ”UF” = Uspecificeret/foreløbig: ikke nødvendigvis placeret i bygning."
		tekstretning		number	ja	Angiver en evt. retningsvinkel for adressen i ”gon” dvs. hvor hele cirklen er 400 gon og 200 er vandret. Værdier 0.00-400.00: Eksempel: ”128.34”.
		ændret		string	ja	Dato for sidste ændring i adressepunktet, som registreret af DAR. Eksempel: ”1998-11-17T00:00:00”
	vejpunkt			object	ja	Et geografisk punkt på færdselsnettet som repræsenterer startpunktet af den rute, der fører til et bestemt adgangspunkt. Beskrivelse: Et "vejpunkt" repræsenterer det sted på vej- eller stinettet e.l., hvorfra adgangsvejen hen imod et adgangspunkt til et areal eller en bygning starter. Ofte vil vejpunktet således angive det sted hvor man forlader vejnettet, for at begive sig det sidste stykke hen imod adgangspunktet (fx indgangen til bygningen) og dermed den adresse, som er turens mål. Vejpunktet repræsenterer således det sted, som et nutidigt bilnavigationssystem typisk vil regne som turens destination eller ankomstpunkt. For et bilnavigatonssystem vil vejruten mellem to adresser blive beregnet mellem de to adressers respektive vejpunkter. Vejpunktet vil som hovedregel være beliggende et sted på den navngivne vej, som adgangspunktets adresser refererer til.
		id		string	nej	Vejpunktets unikke ID
		koordinater		array	ja	Vejpunktets koordinater som array [x,y].
			item	number	nej	koordinat for punktet.
		kilde		string	nej	Kilden til vejpunktets position. Grundkort: Grundkort Matrikelkort: Matrikelkort Ekstern: Ekstern tredjepart Ejer: Ejer eller administrator Landinsp: Landinspektør Adressemyn: Adressemyndigheden
		tekniskstandard		string	nej	Vejpunktets tekniske standard. VU: Vejpunkt er uspecificeret eller ukendt VN: Vejpunkt i vejtilslutningspunkt V0: Vejpunkt på vej med korrekt vejkode. Stor sikkerhed for korrekt vejpunkt V1: Vejpunkt på vej med korrekt vejkode. Adgang til adgangspunkt via indkørselsvej eller sti V2: Vejpunkt på vej med korrekt vejkode. Risiko for at skulle krydse stier V3: Vejpunkt på vej med korrekt vejkode. Risiko for at skulle krydse andre veje V4: Vejpunkt på vej med korrekt vejkode. Risiko for at skulle krydse et enkelt teknisk anlæg eller trafikhegn V5: Vejpunkt på vej med korrekt vejkode. Risiko for at skulle krydse et større antal bygninger eller jordstykker V6: Vejpunkt på mindre indkørselsvej med korrekt vejkode. Risiko for at skulle krydse fysiske forhindringer V7: Vejpunkt på vej med forkert vejkode, men på samme matrikelnummer. Risiko for at skulle krydse fysiske forhindringer V8: Vejpunkt på sti med korrekt vejkode. Risiko for at skulle krydse fysiske forhindringer V9: Vejpunkt på vej eller indkørselsvej med forkert kommunekode eller vejkode. Risiko for at skulle krydse fysiske forhindringer VX: Vejpunkt på vej. Stor usikkerhed om korrekthed
		nøjagtighed		string	nej	Vejpunktets nøjagtighedsklasse. A : Absolut placeret B : Beregnet placering
		ændret		string	nej	Dato og tid hvor der sidst er ændret i vejpunktet i DAR. Angives i dansk tidszone. Eksempel: 2002-04-08T14:38:00.
	DDKN			object	ja	Adressens placering i Det Danske Kvadratnet (DDKN).
		m100		string	nej	Angiver betegnelsen for den 100 m celle som adressen er beliggende i. 15 tegn. Eksempel: ”100m_61768_6435”.
		km1		string	nej	Angiver betegnelsen for den 1 km celle som adressen er beliggende i. 12 tegn. Eksempel: ”1km_6176_643”.
		km10		string	nej	Angiver betegnelsen for den 10 km celle som adressen er beliggende i. 11 tegn. Eksempel: ”10km_617_64”.
	sogn			object	ja	Sognet som adressen er beliggende i. Beregnes udfra adgangspunktet og sogneinddelingerne fra DAGI.
		href		string	nej	Sognets unikke URL.
		kode		string	nej	Sognekoden. 4 cifre.
		navn		string	ja	Sognets navn.
	landsdel			object	ja	Den landsdel, som adressen er beliggende i. Beregnes ud fra adgangspunktet.
		href		string	nej	Landsdelens unikke URL.
		nuts3		string	nej	Landsdelens NUTS3 kode.
		navn		string	nej	Landsdelens navn.
	region			object	ja	Regionen som adressen er beliggende i. Beregnes udfra adgangspunktet og regionsinddelingerne fra DAGI.
		href		string	nej	Regionens unikke URL.
		kode		string	nej	Regionskoden. 4 cifre.
		navn		string	ja	Regionens navn.
	retskreds			object	ja	Retskredsen som adressen er beliggende i. Beregnes udfra adgangspunktet og retskredsinddelingerne fra DAGI.
		href		string	nej	Retskredsens unikke URL.
		kode		string	nej	Retskredskoden. 4 cifre.
		navn		string	ja	Retskredsens navn.
	politikreds			object	ja	Politikredsen som adressen er beliggende i. Beregnes udfra adgangspunktet og politikredsinddelingerne fra DAGI.
		href		string	nej	Politikredsens unikke URL
		kode		string	nej	Identifikation af politikredsen
		navn		string	nej	Politikredsens navn
	afstemningsområde			object	ja
		href		string	nej	Afstemningsområdets URL
		nummer		string	nej	Afstemningsområdets nummer indenfor kommunen
		navn		string	nej	Afstemningsområdets unikke navn
	opstillingskreds			object	ja	Opstillingskresen som adressen er beliggende i. Beregnes udfra adgangspunktet og opstillingskredsinddelingerne fra DAGI.
		href		string	nej	Opstillingskredsens unikke URL
		kode		string	nej	Identifikation af opstillingskredsen.
		navn		string	nej	Opstillingskredsens navn.
	storkreds			object	ja	Den storkreds, som adressen er beliggende i.
		href		string	nej	Storkredsens unikke URL
		nummer		string	nej	Storkredsens nummer.
		navn		string	nej	Storkredsens navn.
	valglandsdel			object	ja	Den valglandsdel, som adressen er beliggende i.
		href		string	nej	Valglandsdelens unikke URL
		bogstav		string	nej	Valglandsdelens bogstav: A, B eller C.
		navn		string	nej	Valglandsdelens navn.
	zone			string	ja	Bemærk. Zone er udfaset - læs mere her. Hvilken zone adressen ligger i. "Byzone", "Sommerhusområde" eller "Landzone". Beregnes udfra adgangspunktet og zoneinddelingerne fra PlansystemDK.
	jordstykke			object	ja	Jordstykket, som adressens adgangspunkt ligger på. Dette kan afvige fra det jordstykke der er registreret i BBR.
		href		string	nej	Jordstykkets unikke URL
		ejerlav		object	nej	Ejerlavet som jordstykket tilhører.
			href	string	nej	Ejerlavets unikke URL.
			kode	integer	nej	Ejerlavets kode. Op til 7 cifre.
			navn	string	nej	Ejerlavets navn.
		matrikelnr		string	nej	Jordstykkets matrikelnummer. Udgør sammen med ejerlavet en unik nøgle for jordstykket. Repræsenteret ved Indtil 7 tegn: max. 4 cifre + max. 3 små bogstaver. Eksempel: ”18b”
		esrejendomsnr		string	nej	⚠ Bemærk! DAWA anvender tilbagekonverteret BBR-data, som ikke længere opdateres fra 16. december 2023. BBR-data udfases helt i DAWA pr. 1. april 2024. Læs mere her. Identifikation af den vurderingsejendom jf. Ejendomsstamregisteret, ESR, som jordstykket er en del af. Repræsenteret ved op til syv cifre. Eksempel ”13606”.
	bebyggelser			array	nej
		id		string	nej	Bebyggelsens unikke ID
		href		string	nej	Bebyggelsens unikke URL
		kode		integer	ja	Bebyggelsens kode. Anvendes bl.a. af Danmarks Statistik
		type		string	nej	Bebyggelsens type. Kan antage værdierne "by", "bydel", "spredtBebyggelse", "sommerhusområde", "sommerhusområdedel", "industriområde", "kolonihave", "storby"
		navn		string	nej	Bebyggelsens navn. Bebyggelsers navne er ikke unikke.
	brofast			boolean	nej	Angiver, om adressen er brofast.

Adresse datavask

Datavask af adresse. Servicen modtager en adressebetegnelse og svarer med 1 eller flere adresser, som bedst matcher svaret. Endvidere er der en angivelse af hvor godt de fundne adresser matcher adressebetegnelsen.

GET https://api.dataforsyningen.dk/datavask/adresser

Parametre

Navn	Beskrivelse
`betegnelse`	Adressebetegnelsen for den adresse som ønskes vasket, f.eks. "Augustenborggade 5, 5. 3, 8000 Aarhus C". Adressebetegnelsen kan leveres med eller uden supplerende bynavn.

Eksempler

Vask adressen "Rante mester vej 8, 4, 2400 København NV"

https://api.dataforsyningen.dk/datavask/adresser?betegnelse=Rante mester vej 8, 4, 2400 København NV

Vask adressen "Borger gade 4, STTV, 6000 Kolding"

https://api.dataforsyningen.dk/datavask/adresser?betegnelse=Borger gade 4, STTV, 6000 Kolding

Datavask svar

Ved anvendelse af datavask-APIet modtages følgende svarstruktur:

Navn				Type	Optionelt	Beskrivelse
kategori				string	nej	Angiver, hvor godt de(n) returnerede adresse(r) matcher adressebetegnelsen. "A" angiver, at den returnerede adresse matcher præcist, bortset fra forskelle på store og små bogstaver samt punktuering. "B" angiver et sikkert match, hvor der dog er mindre variationer (stavefejl eller lignende). C angiver et usikkert match, hvor der er en stor sansynlighed for at den fundne adresse ikke er korrekt. For kategori A og B gælder, at der kun returneres én adresse. For kategori C kan der returneres flere adresser.
resultater				array	nej	En liste af de adresser, som bedst matcher adressebetegnelsen, samt information om hvordan hver enkelt adresse matcher. Listen er ordnet efter hvor godt de matcher adressebetegnelsen med den bedst matchende adresse først.
	adresse			object	nej	Den (muligvis historiske) adresse, som matchede adressebetegnelsen
	aktueladresse			object	nej	Den aktuelle version af den adresse, som matchede adressebetegnelsen. Bemærk, at adressen kan være nedlagt (statuskode 2 eller 4).
	vaskeresultat			object	nej	Information om hvordan adressebetegnelsen matchede den fundne adresse
		afstand		integer	nej	Levenshtein afstanden mellem adressebetegnelsen og den fundne adresses adressebetegnelse
		parsetadresse		object	nej	En angivelse af, hvordan adressebetegnelsen blev parset til en struktureret adresse
		forskelle		object	nej	Levenshtein afstand mellem hvert felt i den parsede adresse og den fundne adresse
		ukendtetokens		array	nej	En liste over de tokens i adressebetegnelsen, som ikke kunne knyttes til en del af den fundne adresse
			item	string	nej	Den ukendte token

Adresse historik

ADVARSEL: Experimentelt API. Der vil ske ændringer i dette API uden varsel, som ikke er bagudkompatible. Hent historik for adresser. Det er kun historiske værdier for udvalgte felter, der er medtaget. Bemærk, at udgåede adresser (statuskode 2 og 4) også medtages i svaret. Historikken returneres som en array af JSON-objekter, hvor hvert objekt repræsenterer en adresses tilstand i den periode, der er angivet med virkningstart og virkningslut. Hvis tilstanden er den aktuelle tilstand har virkningslut værdien null.

GET https://api.dataforsyningen.dk/historik/adresser

Parametre

Navn	Beskrivelse
`id`	Adressens unikke UUID (Flerværdisøgning mulig).
`postnr`	Returner kun historiske adresser med det angivne postnummer (Flerværdisøgning mulig).
`kommunekode`	Returner kun historiske adresser med den angivne kommunekode (Flerværdisøgning mulig).
`adgangsadresseid`	Returner kun adresser på den angivne adgangsadresse (Flerværdisøgning mulig).
`callback`	Output leveres i JSONP format. Se Dataformater.
`format`	Output leveres i andet format end JSON. Se Dataformater.
`noformat`	Parameteren angiver, at whitespaceformatering skal udelades
`ndjson`	Output leveres i Newline Delimited JSON
`side`	Angiver hvilken siden som skal leveres. Se Paginering.
`per_side`	Antal resultater per side. Se Paginering.

Eksempler

Vis historik for adressen med id "4210f8ff-cfca-4b3d-b5c4-ca1c795c14dd"

https://api.dataforsyningen.dk/historik/adresser?id=4210f8ff-cfca-4b3d-b5c4-ca1c795c14dd