Skip to main content
Beta! Dokumentasjonen er automatisk generert. Informasjonen kan være ufullstendig og inneholde feil, spesielt skjermbilder og videoer. Se Om hjelpesidene. Vi vil veldig gjerne ha innspill: Kontakt oss via «Fant du det du lette etter?» nederst, i chatten nede til høyre eller på support@placepoint.no – vi svarer så fort vi kan!

Start with the address, not the matrikkelnummer

Submit an address text in Norway or Sweden and get the matrikkelnummer, postcode and coordinate back in the same answer, ready for the map layer or the next lookup.

Nøkkelen virker i dag på Leietaker-API og dagens Data API; Placepoint API godtar samme nøkkel når det lanseres.

Prøv med et ekte bygg: Oslo S, Jernbanetorget 1

  • Trial key with GitHub in under a minute
  • One GET call
  • Norway and Sweden
  • Kartverket and Lantmäteriet data
  • Coordinate in the answer

ℹ️ The endpoint responds once the Placepoint API has launched. The contract below is final; the Tenant API already responds.

From address to matrikkelnummer

The call answers one question: which property does this address belong to? Banks, agents and developers often have an address from a form, a contract or an enquiry, and need the matrikkelnummer to look up the rest: property, building, owners and transactions.

The address can be Norwegian or Swedish; the country decides which register the answer comes from, Kartverket's address register or Lantmäteriet via Combify. The answer includes a coordinate in the same call, so a system can go straight on to the map layer without another lookup.

  • Handles variation in spelling

    A manual lookup often needs an exact match. The call matches on address text and returns the best match first, so a small difference in spelling does not give zero matches.
  • Coordinate in the same answer

    No separate geocoding service to look up afterwards. The coordinate comes with the same call as the matrikkelnummer.
  • A partial address gives several matches

    An incomplete address text gives several candidates in the same answer instead of one error message, so a system can let the user pick the right match.

Fields that actually tell you something

One GET call with the address text gives the match list below, with the matrikkelnummer and coordinate on each match.

GET/addresses/{country}/{address}
curl -X GET "https://data.placepoint.no/addresses/NO/Karl%20Johans%20gate%201%2C%20Oslo" \
-H "Authorization: Bearer $TOKEN"

svar · 200

{
"items": [
{
"text": "Karl Johans gate 1, 0154 Oslo",
"streetName": "Karl Johans gate",
"houseNumber": "1",
"postalCode": "0154",
"postalPlace": "Oslo",
"country": "NO",
"cadastreId": "0301-207-419-0-0",
"location": {
"lat": 59.9111,
"lon": 10.7528
}
}
]
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (9)
FeltTypeBeskrivelse
items[].textstringOne-line address.
items[].streetNamestringStreet.
items[].houseNumberstringNumber with letter.
items[].postalCodestringPostal code.
items[].postalPlacestringPostal place.
items[].countrystringISO 3166-1 alpha-2.
items[].cadastreIdstringThe property the address belongs to.
items[].location.latnumberLatitude.
items[].location.lonnumberLongitude.

The answer gives cadastreId directly, the matrikkelnummer in Norway and a fastighetsbeteckning slug in Sweden, ready to use in the other endpoints without conversion.

Three steps to your first answer

  1. Log in with GitHub

    One click, under a minute, no payment card. The key comes back to this page.
  2. Call the endpoint

    Replace $TOKEN in the curl above with your key, and send the address text as a parameter.
  3. Use the answer

    cadastreId in the answer goes straight into the property lookup, or send the coordinate on to the map layer.

Data and sources

Norwegian addresses come from Kartverket's address register, updated continuously. Swedish addresses come from Lantmäteriet via Combify, updated continuously.

See also

Questions and answers

How fresh is the data?
Kartverket's address register is updated continuously. Swedish addresses come from Lantmäteriet via Combify and are updated in the same way.
What do you cover?
All registered addresses in Norway and Sweden. A partial address text can give several matches; pick the right match on cadastreId.
Does it work in Sweden?
Yes. Swedish addresses are matched against Lantmäteriet's register via Combify, and the answer uses the same field names as the Norwegian one.
What kind of matrikkelnummer do I get back?
cadastreId is already in the right form: matrikkelnummer in Norway, fastighetsbeteckning slug in Sweden. No conversion needed before you call the other endpoints.
Beta! Dokumentasjonen er automatisk generert. Informasjonen kan være ufullstendig og inneholde feil, spesielt skjermbilder og videoer. Se Om hjelpesidene. Vi vil veldig gjerne ha innspill: Kontakt oss via «Fant du det du lette etter?» nederst, i chatten nede til høyre eller på support@placepoint.no – vi svarer så fort vi kan!