Vad vet vi om fastigheten?
Matrikkelnummeret ger areal, adresser, kommun och länkar vidare till byggnader, ägare och transaktioner, plus bulkuppslag för flera fastigheter och en översikt över fastighetens sektioner.
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
- Provnyckel med GitHub på under en minut
- Ett GET-anrop
- Norge och Sverige
- Kartverket-data
- Bulkuppslag upp till 100
ℹ️ Endpunkten svarar när Placepoint API har lanserats. Kontraktet nedan är slutgiltigt, Hyresgäst-API svarar redan.
Från matrikkelnummer till fastighet
Fastighetsuppslaget svarar på vad vi vet om denna matrikkelenhet: areal, adresser, kommun och fastighetstyp, plus länkar vidare till byggnader, ägare, hyresgäster och transaktioner. Banker och mäklare använder det för att verifiera en fastighet före värdering, byggherrar använder det för att hämta grunddata före en djupare analys.
Bulkuppslaget svarar på samma fråga för en lista med matrikkelnummer i ett anrop, i stället för ett anrop per fastighet. Sektionslistan svarar på hur en sektionerad fastighet är uppdelad: ägarsektionerna, andelstal och vem som äger varje sektion.
Bulkuppslag i ett anrop
Upp till 100 matrikkelnummer i ett anrop i stället för ett anrop per fastighet. EnnotFound-lista visar vilka som inte gav träff, ochIdempotency-Keyåteranvänder svaret i 24 timmar vid upprepat anrop.Direkt vidare till underresurserna
Svaret har länkar vidare till byggnader, ägare och hyresgäster, så ett system slipper konstruera URL:erna själv.Sektionerna med ägarandel
Sektionslistan ger andelstal och ägare per sektion, samma uppgift som ägarsektioner annars kräver en manuell sökning i Grunnboken för.
Fält som faktiskt säger något
Fastighet 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"
}
]
}
Flera fastigheter i ett anrop.
/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": []
}
Sektionerna på en fastighet.
/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 till första svaret
Logga in med GitHub
Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till denna sida.Anropa endpunkten
Byt ut$TOKENi curl-anropet ovan. Anropet behöver landskod och matrikkelnummer, det du redan har i portföljen.Använd svaret
Använd länkarna i svaret för att hämta byggnader, ägare eller hyresgäster för samma fastighet utan ett nytt uppslag.
Data och källor
Matrikkeldata och sektioner kommer från Kartverkets matrikkel, uppdaterad löpande.
Se även
Frågor och svar
Hur färska är uppgifterna?
Vad täcker ni?
Fungerar det i Sverige?
Vad kostar ett bulkuppslag?
properties.read, oavsett om det ger träff eller hamnar i notFound. Idempotency-Key återanvänder svaret vid ett upprepat anrop i 24 timmar.