Kva veit vi om eigedommen?
Matrikkelnummeret gir areal, adresser, kommune og lenkjer vidare til bygg, eigarar og transaksjonar, pluss bulkoppslag for fleire eigedommar og ei oversikt over seksjonane på eigedommen.
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
- Prøvenøkkel med GitHub på under eitt minutt
- Eitt GET-kall
- Noreg og Sverige
- Kartverket-data
- Bulkoppslag inntil 100
ℹ️ Endepunktet svarer når Placepoint API er lansert. Kontrakten under er endeleg; Leigetakar-API svarer allereie.
Frå matrikkelnummer til eigedom
Eigedomsoppslaget svarer på kva vi veit om denne matrikkelenheten: areal, adresser, kommune og eigedomstype, pluss lenkjer vidare til bygg, eigarar, leigetakarar og transaksjonar. Bankar og meklarar bruker det til å verifisere ein eigedom før verdivurdering; utbyggjarar bruker det til å hente grunndata før ei djupare analyse.
Bulkoppslaget svarer på det same spørsmålet for ei liste med matrikkelnummer i eitt kall, i staden for eitt kall per eigedom. Seksjonslista svarer på korleis ein seksjonert eigedom er delt opp: eigarseksjonane, sameigebrøk og kven som eig kvar seksjon.
Bulkoppslag i eitt kall
Inntil 100 matrikkelnummer i eitt kall i staden for eitt kall per eigedom. EinotFound-liste seier kva for nokre som ikkje gav treff, ogIdempotency-Keygjenbruker svaret i 24 timar ved gjenteke kall.Rett vidare til underressursane
Svaret har lenkjer vidare til bygg, eigarar og leigetakarar, så eit system slepp å konstruere URL-ane sjølv.Seksjonane med eigardel
Seksjonslista gir sameigebrøk og eigar per seksjon, same opplysninga som eigarseksjonar elles krev eit manuelt oppslag i grunnboken for.
Felt som faktisk seier noko
Eigedom på matrikkelnummer.
/properties/{country}/{cadastreId}curl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0" \
-H "Authorization: Bearer $TOKEN"
svar · 200
{
"country": "NO",
"cadastreId": "0301-207-76-0-0",
"municipality": {
"code": "0301",
"name": "Oslo"
},
"areaM2": 620,
"plotCount": 1,
"propertyType": "EIERSEKSJON",
"buildingCount": 1,
"sectionCount": 44,
"unitCount": 52,
"totalUsableAreaM2": 26400,
"totalGrossAreaM2": 28900,
"builtOverAreaM2": 2050,
"builtOverAreaPct": 33.1,
"averageFloors": 13,
"taxationValue": {
"amount": "412000000.00",
"currency": "NOK"
},
"establishedDate": "1998-03-11",
"location": {
"lat": 59.9075,
"lon": 10.7563
},
"addresses": [
{
"text": "Dronning Eufemias gate 16, 0191 Oslo",
"streetName": "Dronning Eufemias gate",
"houseNumber": "16",
"postalCode": "0191",
"postalPlace": "Oslo",
"country": "NO",
"cadastreId": "0301-207-76-0-0",
"location": {
"lat": 59.9075,
"lon": 10.7563
}
}
],
"links": [
{
"href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/sections",
"title": "Sections"
},
{
"href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/buildings",
"title": "Buildings"
},
{
"href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/units",
"title": "Units"
}
]
}
Fleire eigedommar i eitt kall.
/properties/{country}/lookupscurl -X POST "https://data.placepoint.no/properties/NO/lookups" \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"cadastreIds":["0301-207-76-0-0"]}'
svar · 200
{
"items": [
{
"country": "NO",
"cadastreId": "0301-207-76-0-0",
"municipality": {
"code": "0301",
"name": "Oslo"
},
"areaM2": 620,
"plotCount": 1,
"propertyType": "EIERSEKSJON",
"addresses": [
{
"text": "Dronning Eufemias gate 16, 0191 Oslo",
"streetName": "Dronning Eufemias gate",
"houseNumber": "16",
"postalCode": "0191",
"postalPlace": "Oslo",
"country": "NO",
"cadastreId": "0301-207-76-0-0",
"location": {
"lat": 59.9075,
"lon": 10.7563
}
}
],
"links": [
{
"href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/sections",
"title": "Sections"
},
{
"href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/buildings",
"title": "Buildings"
},
{
"href": "https://data.placepoint.no/properties/NO/0301-207-76-0-0/units",
"title": "Units"
}
]
}
],
"notFound": []
}
Seksjonane på ein eigedom.
/properties/{country}/{cadastreId}/sectionscurl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0/sections" \
-H "Authorization: Bearer $TOKEN"
svar · 200
{
"items": [
{
"sectionNumber": "15",
"cadastreId": "0301-207-76-0-0",
"share": {
"numerator": 1,
"denominator": 1
},
"owners": [
{
"kind": "ORGANIZATION",
"organization": {
"organizationIdentifier": {
"scheme": "0192",
"id": "987654321"
},
"name": "Eufemia Eiendom AS",
"country": "NO"
},
"share": {
"numerator": 1,
"denominator": 2
},
"registeredAt": "2019-06-01T00:00:00Z"
},
{
"kind": "PERSON",
"person": {
"birthYear": 1978
},
"share": {
"numerator": 1,
"denominator": 2
},
"registeredAt": "2020-01-15T00:00:00Z"
}
],
"useType": "NAERING"
}
]
}
Tre steg til første svar
Logg inn med GitHub
Eitt klikk, under eitt minutt, ingen betalingskort. Nøkkelen kjem tilbake til denne sida.Kall endepunktet
Byt ut$TOKENi curl-en over. Kallet treng landkode og matrikkelnummer, det du alt har i porteføljen.Bruk svaret
Bruk lenkjene i svaret til å hente bygg, eigarar eller leigetakarar for same eigedom utan eit nytt oppslag.
Data og kjelder
Matrikkeldata og seksjonar kjem frå matrikkelen til Kartverket, oppdatert løpande.
Sjå òg
Spørsmål og svar
Kor ferske er dataa?
Kva dekkjer de?
Verkar det i Sverige?
Kva kostar eit bulkoppslag?
properties.read-kvoten, anten den gir treff eller hamnar i notFound. Idempotency-Key gjenbruker svaret på eit gjenteke kall i 24 timar.