Hopp til hovudinnhaldet
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!

Kven eig eigedomen?

Heimelshavarane registrerte på ein eigedom, selskap eller person, med eigardel og registreringsdato, same opplysning grunnboksutskrifta viser.

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
  • Grunnboka
  • Scope-styrt personvern
  • Oppdatert løpande

ℹ️ Endepunktet svarar når Placepoint API er lansert. Kontrakten under er endeleg; Leigetakar-API svarar allereie.

Frå matrikkelnummer til heimelshavarar

Kallet svarar på kven som eig eigedomen i dag. Bankar bruker det til å verifisere motpart før lån, meklarar til å stadfeste seljar, og forvaltarar til å halde eigarlister oppdaterte på tvers av ein portefølje utan å bestille grunnboksutskrift for kvar eigedom.

Selskapseigarar kjem med organisasjonsnummer og namn direkte. For personeigarar krev namnet scopet owners.read; utan det scopet returnerer kallet berre fødselsår (når det finst), same avgrensing som seksjonsoppslaget bruker. Det er ei medviten avgrensing: eigardel og at eigedomen har ein personeigar er offentleg via Grunnboka, men namnet krev ein tydelegare avtale om kva det skal brukast til.

  • Same opplysning som grunnboksutskrifta

    Inga manuell bestilling per eigedom. Kallet gir heimelshavarane direkte, med eigardel og registreringsdato.
  • Organisasjonsnummer med ein gong

    Selskapseigarar kjem med organisasjonsnummer og namn i same svar, klare til å kjede vidare inn i selskapsoppslaget.
  • Personvern styrt av scope

    Personeigarar krev owners.read for namnet; utan scopet får du berre fødselsår, når det er kjent.

Felt som faktisk seier noko

Eitt GET-kall med matrikkelnummeret gir eigarlista under.

GET/properties/{country}/{cadastreId}/owners
curl -X GET "https://data.placepoint.no/properties/NO/0301-207-76-0-0/owners" \
-H "Authorization: Bearer $TOKEN"

svar · 200

{
"items": [
{
"kind": "ORGANIZATION",
"organization": {
"organizationIdentifier": {
"scheme": "0192",
"id": "987654321"
},
"name": "Eufemia Eiendom AS",
"country": "NO"
},
"share": {
"numerator": 1,
"denominator": 1
},
"registeredAt": "2019-06-01T00:00:00Z"
}
]
}

Scope: properties.readTeknisk referanse og Try-it

Vis alle felt (15)
FeltTypeBeskrivelse
items[].kindstringWhich nested object is populated.
items[].person.namestringFull name.
items[].person.birthYearintegerYear of birth.
items[].organization.organizationIdentifier.schemestringISO 6523 ICD code.
items[].organization.organizationIdentifier.idstringRegister identifier.
items[].organization.namestringRegistered name.
items[].organization.countrystringISO 3166-1 alpha-2.
items[].organization.links[].hrefstringAbsolute URL.
items[].organization.links[].titlestringHuman label.
items[].share.numeratorintegerNumerator.
items[].share.denominatorintegerDenominator.
items[].registeredAtstringWhen the register recorded it.
items[].interestTypestringThe interest the grunnbok records, e.g. Hjemmelshaver or Fester.
items[].contactRolestringRegistered contact role, where the party is recorded as a contact rather than a holder.
items[].untilDatestringWhen the interest ended. Absent means the interest is current, which is the only way to tell a former owner from a present one.

Tre steg til første svar

  1. Logg inn med GitHub

    Eitt klikk, under eitt minutt, ingen betalingskort. Nøkkelen kjem tilbake til denne sida.
  2. Kall endepunktet

    Byt ut $TOKEN i curl-en over. Kallet treng landkode og matrikkelnummer, same parametrar som eigedomsoppslaget.
  3. Bruk svaret

    Bruk eigarlista til å verifisere motpart før lån, eller til å halde eigarlister oppdaterte på tvers av porteføljen.

Data og kjelder

Eigardata kjem frå Grunnboka hos Kartverket, oppdatert løpande.

Sjå også

Spørsmål og svar

Kor ferske er dataa?
Grunnboka hos Kartverket blir oppdatert løpande.
Verkar det i Sverige?
Ja. listPropertyOwners tek country=SE på same måte som dei andre eigedomskalla, og svenske heimelshavarar kjem via Combify og Lantmäteriet. Same personvernregel gjeld: privatpersonar krev owners.read-scopet for namnet, elles berre fødselsår når det er kjent.
Kva skjer utan owners.read-scopet?
Selskapseigarar blir alltid viste med organisasjonsnummer og namn. For personeigarar blir berre fødselsår returnert, når det er kjent; namnet krev owners.read-scopet.
Kva med personvern?
Eigardel og at eigedomen har ein personeigar er offentleg via Grunnboka. Namnet krev eit tydelegare avtalt formål, styrt via scopet owners.read.
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!