Adresser

An adresse is a full Danish address: an access address (street, house number, postcode) plus the floor (etage) and door (dør), where it has them. Its id is the DAR UUID, the same id DAWA gave it, so ids you have stored still work.

/adresser/{id}

1 look-up. An id that is not found answers 404 ResourceNotFoundError and costs nothing.

Parameter	Default	Description
id (path)		The address's UUID.
struktur	nestet	`nestet`: the address with its access address, street, postcode, municipality, region and the rest nested inside. `flad`: every field at the top level. `mini`: the fields an address form needs.
srid	4326	`4326` (WGS84 longitude/latitude) or `25832` (ETRS89 / UTM zone 32N, metres).
format	json	`json` or `geojson` (a GeoJSON Feature, the record as its properties).

struktur=mini

Request

GET https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b?struktur=mini&api-key={your-api-key}

Response

{
  "id": "3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b",
  "status": 1,
  "darstatus": 3,
  "vejkode": "0108",
  "vejnavn": "Amagerbrogade",
  "adresseringsvejnavn": "Amagerbrogade",
  "husnr": "217A",
  "etage": "kl",
  "dør": "5",
  "supplerendebynavn": null,
  "postnr": "2300",
  "postnrnavn": "København S",
  "stormodtagerpostnr": null,
  "stormodtagerpostnrnavn": null,
  "kommunekode": "0101",
  "adgangsadresseid": "099f3e28-4fb8-4c61-86a1-edff5df52409",
  "x": 12.6135425,
  "y": 55.6489036,
  "href": "https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b",
  "betegnelse": "Amagerbrogade 217A, kl. 5, 2300 København S"
}

struktur=nestet (the default)

Request

GET https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b?api-key={your-api-key}

Response

{
  "id": "3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b",
  "kvhx": "01010108217A_kl___5",
  "status": 1,
  "darstatus": 3,
  "href": "https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b",
  "historik": {
    "oprettet": "2013-01-03T13:56:48.627",
    "ændret": "2013-01-03T13:56:48.627",
    "ikrafttrædelse": "2013-01-03T13:56:48.627",
    "nedlagt": null
  },
  "etage": "kl",
  "dør": "5",
  "adressebetegnelse": "Amagerbrogade 217A, kl. 5, 2300 København S",
  "adgangsadresse": {
    "href": "https://api.getaddress.dk/adgangsadresser/099f3e28-4fb8-4c61-86a1-edff5df52409",
    "id": "099f3e28-4fb8-4c61-86a1-edff5df52409",
    "adressebetegnelse": "Amagerbrogade 217A, 2300 København S",
    "kvh": "01010108217A",
    "status": 1,
    "darstatus": 3,
    "vejstykke": {
      "href": "https://api.getaddress.dk/vejstykker/101/108",
      "navn": "Amagerbrogade",
      "adresseringsnavn": "Amagerbrogade",
      "kode": "0108"
    },
    "husnr": "217A",
    "navngivenvej": {
      "href": "https://api.getaddress.dk/navngivneveje/b1c9679c-f9ad-4633-9013-73a3d3f77433",
      "id": "b1c9679c-f9ad-4633-9013-73a3d3f77433"
    },
    "supplerendebynavn": null,
    "supplerendebynavn2": null,
    "postnummer": {
      "href": "https://api.getaddress.dk/postnumre/2300",
      "nr": "2300",
      "navn": "København S"
    },
    "stormodtagerpostnummer": null,
    "kommune": {
      "href": "https://api.getaddress.dk/kommuner/0101",
      "kode": "0101",
      "navn": "København"
    },
    "ejerlav": {
      "kode": 2000172,
      "navn": "Sundbyøster, København"
    },
    "esrejendomsnr": "0",
    "matrikelnr": "39a",
    "historik": {
      "oprettet": "2010-11-25T13:06:50.077",
      "ændret": "2018-07-04T18:00:00.000",
      "ikrafttrædelse": "2012-12-10T13:52:28.567",
      "nedlagt": null
    },
    "adgangspunkt": {
      "id": "03585431-b347-4aae-96cc-dadbafeebead",
      "koordinater": [
        12.6135425,
        55.6489036
      ],
      "højde": 5,
      "nøjagtighed": "A",
      "kilde": 1,
      "tekniskstandard": "TD",
      "tekstretning": 280.43,
      "ændret": "2012-12-10T23:59:00.000"
    },
    "vejpunkt": {
      "id": "11bcf1c7-af45-11e7-847e-066cff24d637",
      "kilde": "Ekstern",
      "nøjagtighed": "B",
      "tekniskstandard": "V0",
      "koordinater": [
        12.61319478,
        55.64885345
      ],
      "ændret": "2018-05-03T14:08:02.125"
    },
    "DDKN": {
      "m100": "100m_61729_7273",
      "km1": "1km_6172_727",
      "km10": "10km_617_72"
    },
    "sogn": {
      "href": "https://api.getaddress.dk/sogne/7089",
      "kode": "7089",
      "navn": "Simon Peters"
    },
    "region": {
      "href": "https://api.getaddress.dk/regioner/1084",
      "kode": "1084",
      "navn": "Region Hovedstaden"
    },
    "landsdel": {
      "href": "https://api.getaddress.dk/landsdele/DK011",
      "nuts3": "DK011",
      "navn": "Byen København"
    },
    "retskreds": {
      "href": "https://api.getaddress.dk/retskredse/1101",
      "kode": "1101",
      "navn": "Københavns Byret"
    },
    "politikreds": {
      "href": "https://api.getaddress.dk/politikredse/1470",
      "kode": "1470",
      "navn": "Københavns Politi"
    },
    "opstillingskreds": {
      "href": "https://api.getaddress.dk/opstillingskredse/0004",
      "kode": "0004",
      "navn": "Sundbyøster"
    },
    "afstemningsområde": {
      "href": "https://api.getaddress.dk/afstemningsomraader/101/18",
      "nummer": "18",
      "navn": "4. Syd"
    },
    "storkreds": {
      "href": "https://api.getaddress.dk/storkredse/1",
      "nummer": "1",
      "navn": "København"
    },
    "valglandsdel": {
      "href": "https://api.getaddress.dk/valglandsdele/A",
      "bogstav": "A",
      "navn": "Hovedstaden"
    },
    "zone": "Udfaset",
    "jordstykke": {
      "href": "https://api.getaddress.dk/jordstykker/2000172/39a",
      "ejerlav": {
        "kode": 2000172,
        "navn": "Sundbyøster, København",
        "href": "https://api.getaddress.dk/ejerlav/2000172"
      },
      "matrikelnr": "39a",
      "esrejendomsnr": "0"
    },
    "bebyggelser": [],
    "brofast": true
  }
}

bebyggelser is always empty here, and some nested blocks come from registers other than DAR — see Differences from DAWA.

struktur=flad

Request

GET https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b?struktur=flad&api-key={your-api-key}

Response

{
  "id": "3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b",
  "status": 1,
  "darstatus": 3,
  "oprettet": "2013-01-03T13:56:48.627",
  "ændret": "2013-01-03T13:56:48.627",
  "ikrafttrædelse": "2013-01-03T13:56:48.627",
  "nedlagt": null,
  "vejkode": "0108",
  "vejnavn": "Amagerbrogade",
  "adresseringsvejnavn": "Amagerbrogade",
  "husnr": "217A",
  "etage": "kl",
  "dør": "5",
  "supplerendebynavn": null,
  "postnr": "2300",
  "postnrnavn": "København S",
  "stormodtagerpostnr": null,
  "stormodtagerpostnrnavn": null,
  "kommunekode": "0101",
  "kommunenavn": "København",
  "ejerlavkode": 2000172,
  "ejerlavnavn": "Sundbyøster, København",
  "matrikelnr": "39a",
  "esrejendomsnr": "0",
  "etrs89koordinat_øst": 727352.84,
  "etrs89koordinat_nord": 6172926.85,
  "wgs84koordinat_bredde": 55.6489036,
  "wgs84koordinat_længde": 12.6135425,
  "nøjagtighed": "A",
  "kilde": 1,
  "tekniskstandard": "TD",
  "tekstretning": 280.43,
  "ddkn_m100": "100m_61729_7273",
  "ddkn_km1": "1km_6172_727",
  "ddkn_km10": "10km_617_72",
  "adressepunktændringsdato": "2012-12-10T23:59:00.000",
  "adgangsadresseid": "099f3e28-4fb8-4c61-86a1-edff5df52409",
  "adgangsadresse_status": 1,
  "adgangsadresse_darstatus": 3,
  "adgangsadresse_oprettet": "2010-11-25T13:06:50.077",
  "adgangsadresse_ændret": "2018-07-04T18:00:00.000",
  "adgangsadresse_ikrafttrædelse": "2012-12-10T13:52:28.567",
  "adgangsadresse_nedlagt": null,
  "regionskode": "1084",
  "regionsnavn": "Region Hovedstaden",
  "jordstykke_ejerlavnavn": "Sundbyøster, København",
  "jordstykke_ejerlavkode": 2000172,
  "jordstykke_matrikelnr": "39a",
  "jordstykke_esrejendomsnr": "0",
  "højde": 5,
  "adgangspunktid": "03585431-b347-4aae-96cc-dadbafeebead",
  "vejpunkt_x": 12.61319478,
  "vejpunkt_y": 55.64885345,
  "vejpunkt_id": "11bcf1c7-af45-11e7-847e-066cff24d637",
  "vejpunkt_kilde": "Ekstern",
  "vejpunkt_nøjagtighed": "B",
  "vejpunkt_tekniskstandard": "V0",
  "vejpunkt_ændret": "2018-05-03T14:08:02.125",
  "sognekode": "7089",
  "sognenavn": "Simon Peters",
  "politikredskode": "1470",
  "politikredsnavn": "Københavns Politi",
  "retskredskode": "1101",
  "retskredsnavn": "Københavns Byret",
  "opstillingskredskode": "0004",
  "opstillingskredsnavn": "Sundbyøster",
  "zone": "Udfaset",
  "afstemningsområdenummer": "18",
  "afstemningsområdenavn": "4. Syd",
  "menighedsrådsafstemningsområdenummer": 47,
  "menighedsrådsafstemningsområdenavn": "Simon Peters",
  "brofast": true,
  "supplerendebynavn_dagi_id": null,
  "navngivenvej_id": "b1c9679c-f9ad-4633-9013-73a3d3f77433",
  "storkredsnummer": "1",
  "storkredsnavn": "København",
  "valglandsdelsbogstav": "A",
  "valglandsdelsnavn": "Hovedstaden",
  "landsdelsnuts3": "DK011",
  "landsdelsnavn": "Byen København",
  "kvhx": "01010108217A_kl___5",
  "kvh": "01010108217A",
  "betegnelse": "Amagerbrogade 217A, kl. 5, 2300 København S"
}

format=geojson

Request

GET https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b?format=geojson&api-key={your-api-key}

Response

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      12.6135425,
      55.6489036
    ]
  },
  "crs": {
    "type": "name",
    "properties": {
      "name": "EPSG:4326"
    }
  },
  "properties": {
    "id": "3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b",
    "status": 1,
    "darstatus": 3,
    "oprettet": "2013-01-03T13:56:48.627",
    "ændret": "2013-01-03T13:56:48.627",
    "ikrafttrædelse": "2013-01-03T13:56:48.627",
    "nedlagt": null,
    "vejkode": "0108",
    "vejnavn": "Amagerbrogade",
    "adresseringsvejnavn": "Amagerbrogade",
    "husnr": "217A",
    "etage": "kl",
    "dør": "5",
    "supplerendebynavn": null,
    "postnr": "2300",
    "postnrnavn": "København S",
    "stormodtagerpostnr": null,
    "stormodtagerpostnrnavn": null,
    "kommunekode": "0101",
    "kommunenavn": "København",
    "ejerlavkode": 2000172,
    "ejerlavnavn": "Sundbyøster, København",
    "matrikelnr": "39a",
    "esrejendomsnr": "0",
    "etrs89koordinat_øst": 727352.84,
    "etrs89koordinat_nord": 6172926.85,
    "wgs84koordinat_bredde": 55.6489036,
    "wgs84koordinat_længde": 12.6135425,
    "nøjagtighed": "A",
    "kilde": 1,
    "tekniskstandard": "TD",
    "tekstretning": 280.43,
    "ddkn_m100": "100m_61729_7273",
    "ddkn_km1": "1km_6172_727",
    "ddkn_km10": "10km_617_72",
    "adressepunktændringsdato": "2012-12-10T23:59:00.000",
    "adgangsadresseid": "099f3e28-4fb8-4c61-86a1-edff5df52409",
    "adgangsadresse_status": 1,
    "adgangsadresse_darstatus": 3,
    "adgangsadresse_oprettet": "2010-11-25T13:06:50.077",
    "adgangsadresse_ændret": "2018-07-04T18:00:00.000",
    "adgangsadresse_ikrafttrædelse": "2012-12-10T13:52:28.567",
    "adgangsadresse_nedlagt": null,
    "regionskode": "1084",
    "regionsnavn": "Region Hovedstaden",
    "jordstykke_ejerlavnavn": "Sundbyøster, København",
    "jordstykke_ejerlavkode": 2000172,
    "jordstykke_matrikelnr": "39a",
    "jordstykke_esrejendomsnr": "0",
    "højde": 5,
    "adgangspunktid": "03585431-b347-4aae-96cc-dadbafeebead",
    "vejpunkt_x": 12.61319478,
    "vejpunkt_y": 55.64885345,
    "vejpunkt_id": "11bcf1c7-af45-11e7-847e-066cff24d637",
    "vejpunkt_kilde": "Ekstern",
    "vejpunkt_nøjagtighed": "B",
    "vejpunkt_tekniskstandard": "V0",
    "vejpunkt_ændret": "2018-05-03T14:08:02.125",
    "sognekode": "7089",
    "sognenavn": "Simon Peters",
    "politikredskode": "1470",
    "politikredsnavn": "Københavns Politi",
    "retskredskode": "1101",
    "retskredsnavn": "Københavns Byret",
    "opstillingskredskode": "0004",
    "opstillingskredsnavn": "Sundbyøster",
    "zone": "Udfaset",
    "afstemningsområdenummer": "18",
    "afstemningsområdenavn": "4. Syd",
    "menighedsrådsafstemningsområdenummer": 47,
    "menighedsrådsafstemningsområdenavn": "Simon Peters",
    "brofast": true,
    "supplerendebynavn_dagi_id": null,
    "navngivenvej_id": "b1c9679c-f9ad-4633-9013-73a3d3f77433",
    "storkredsnummer": "1",
    "storkredsnavn": "København",
    "valglandsdelsbogstav": "A",
    "valglandsdelsnavn": "Hovedstaden",
    "landsdelsnuts3": "DK011",
    "landsdelsnavn": "Byen København",
    "kvhx": "01010108217A_kl___5",
    "kvh": "01010108217A",
    "betegnelse": "Amagerbrogade 217A, kl. 5, 2300 København S"
  }
}

/adresser

Searches addresses by text and fields, a page at a time. 1 look-up per address returned; a page with nothing on it costs nothing. The answer is an array of records in the requested struktur, or a GeoJSON FeatureCollection with format=geojson.

Parameter	Description
q	Text search: every word must be a word of the address; a word ending in `*` may be the start of one.
id	These addresses; several ids separated by `\|`.
adgangsadresseid	The addresses at this access address.
vejnavn, vejkode	Street name, or street code (with `kommunekode`).
husnr	House number, e.g. `217A`.
etage, dør	Floor and door, e.g. `kl`, `st`, `2` / `th`, `tv`, `5`. With no value (`etage=`) they mean an address with none.
supplerendebynavn	Supplementary town name.
postnr	Postcode; several separated by `\|`.
kommunekode	Municipality code, e.g. `0101`; several separated by `\|`.
side	Page number, from 1.
per_side	Page size. Default and maximum 100.
struktur, srid, format	As for `/adresser/{id}`.

A text search

Request

GET https://api.getaddress.dk/adresser?q=Amagerbrogade%20217A&postnr=2300&struktur=mini&api-key={your-api-key}

Response — the first 2 of 16 shown

[
  {
    "id": "415d291b-648c-4908-bfea-dc75aec543d1",
    "status": 1,
    "darstatus": 3,
    "vejkode": "0108",
    "vejnavn": "Amagerbrogade",
    "adresseringsvejnavn": "Amagerbrogade",
    "husnr": "217A",
    "etage": null,
    "dør": null,
    "supplerendebynavn": null,
    "postnr": "2300",
    "postnrnavn": "København S",
    "stormodtagerpostnr": null,
    "stormodtagerpostnrnavn": null,
    "kommunekode": "0101",
    "adgangsadresseid": "099f3e28-4fb8-4c61-86a1-edff5df52409",
    "x": 12.6135425,
    "y": 55.6489036,
    "href": "https://api.getaddress.dk/adresser/415d291b-648c-4908-bfea-dc75aec543d1",
    "betegnelse": "Amagerbrogade 217A, 2300 København S"
  },
  {
    "id": "5a8a8e5f-510c-4432-8aab-a01768218537",
    "status": 1,
    "darstatus": 3,
    "vejkode": "0108",
    "vejnavn": "Amagerbrogade",
    "adresseringsvejnavn": "Amagerbrogade",
    "husnr": "217A",
    "etage": "kl",
    "dør": null,
    "supplerendebynavn": null,
    "postnr": "2300",
    "postnrnavn": "København S",
    "stormodtagerpostnr": null,
    "stormodtagerpostnrnavn": null,
    "kommunekode": "0101",
    "adgangsadresseid": "099f3e28-4fb8-4c61-86a1-edff5df52409",
    "x": 12.6135425,
    "y": 55.6489036,
    "href": "https://api.getaddress.dk/adresser/5a8a8e5f-510c-4432-8aab-a01768218537",
    "betegnelse": "Amagerbrogade 217A, kl., 2300 København S"
  }
]

Paging

Page 2 of 10 records per page, in municipality 0101 (10 look-ups):

Request

GET https://api.getaddress.dk/adresser?kommunekode=0101&per_side=10&side=2&struktur=mini&api-key={your-api-key}

Response — the first 1 of 10 shown

[
  {
    "id": "0004f365-27bf-4be5-a64a-a81ec533d1b4",
    "status": 1,
    "darstatus": 3,
    "vejkode": "8839",
    "vejnavn": "Pladehals Allé",
    "adresseringsvejnavn": "Pladehals Allé",
    "husnr": "41",
    "etage": "2",
    "dør": "tv",
    "supplerendebynavn": null,
    "postnr": "2450",
    "postnrnavn": "København SV",
    "stormodtagerpostnr": null,
    "stormodtagerpostnrnavn": null,
    "kommunekode": "0101",
    "adgangsadresseid": "f216bde9-be2a-42ca-abbb-f6db34a6c7cf",
    "x": 12.55072736,
    "y": 55.65645711,
    "href": "https://api.getaddress.dk/adresser/0004f365-27bf-4be5-a64a-a81ec533d1b4",
    "betegnelse": "Pladehals Allé 41, 2. tv, 2450 København SV"
  }
]

Results come in a stable order, so paging through a search returns every match once. The order of a text search is not always DAWA's. There is no unpaged download: every search pages.