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 selskapet?

Aksjonærlista for eit selskap: kvar aksjonær med eigardel, aksjeklasse og kven som er reell rettshavar, ikkje berre kven som står øvst i kjeda.

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 selskap: Eksempel Eigedom AS

  • Prøvenøkkel med GitHub på under eitt minutt
  • Eitt GET-kall
  • ISO 6523-identifikatorar
  • Noreg og Sverige
  • Brønnøysundregistrene-verifisert

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

Frå organisasjonsnummer til eigarbilete

Kallet svarar på kven som faktisk eig selskapet. Bankar bruker aksjonærlista til å kjenne motparten før eit kredittvedtak, meklarar til å sjå om eit salsoppdrag involverer fleire eigarar som må bli samde, og compliance-team til å identifisere kven som til slutt sit med kontrollen.

Kvar oppføring er ein person eller eit anna selskap, med eigardel som brøk, aksjeklasse og tal på aksjar. Ein organisasjon kjem med fullt organisasjonsnummer og namn. Ein person kjem med fødselsår som standard; fullt namn krev i tillegg scopet owners.read, same avgrensing som eigaroppslaget på ein eigedom bruker.

isUltimateBeneficialOwner flaggar ein aksjonær som er registrert som reell rettshavar, altså personen som til slutt kontrollerer selskapet, uansett kor mange ledd eigarskapet går gjennom.

  • Reell rettshavar i same kall

    isUltimateBeneficialOwner svarar direkte på kven som til slutt kontrollerer selskapet, utan at du må følgje eigarkjeda oppover manuelt gjennom fleire selskapsoppslag.
  • Eigardel som brøk, ikkje prosent runda bort

    share.numerator og share.denominator gir den eksakte eigardelen. Ein avrunda prosent i eit manuelt oppslag skjuler skilnaden mellom 49,9 og 50,1 prosent.
  • Selskap og person i same liste

    Ein aksjonær som er eit holdingselskap og ein aksjonær som er ein person kjem i same liste, med kind som skil dei. Inga separat liste å slå saman sjølv.

Felt som faktisk seier noko

Eitt GET-kall på scheme og id til selskapet gir heile aksjonærregisteret. Felta under er dei som avgjer kva du kan lese ut av kvar aksjonær.

GET/companies/{scheme}/{id}/shareholders
curl -X GET "https://data.placepoint.no/companies/0192/987654321/shareholders" \
-H "Authorization: Bearer $TOKEN"

svar · 200

{
"items": [
{
"kind": "ORGANIZATION",
"organization": {
"organizationIdentifier": {
"scheme": "0192",
"id": "911222333"
},
"name": "Eksempel Holding AS",
"country": "NO"
},
"share": {
"numerator": 3,
"denominator": 4
},
"registeredAt": "2018-01-10T00:00:00Z",
"shareClass": "A",
"shares": 750,
"isUltimateBeneficialOwner": true
},
{
"kind": "PERSON",
"person": {
"birthYear": 1968
},
"share": {
"numerator": 1,
"denominator": 4
},
"registeredAt": "2018-01-10T00:00:00Z",
"shareClass": "A",
"shares": 250,
"isUltimateBeneficialOwner": false
}
]
}

Scope: companies.readTeknisk referanse og Try-it

Vis alle felt (20)
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.
items[].shareClassstringShare class, e.g. A or B.
items[].sharesintegerNumber of shares held.
items[].isUltimateBeneficialOwnerbooleanWhether the shareholder is recorded as a reell rettighetshaver.
items[].fiscalYearintegerThe aksjonærregister year the entry is taken from.
items[].sourceDatestringWhen the register data was collected.

Utan scopet owners.read blir berre person.birthYear returnert for ein personaksjonær, aldri namnet. isUltimateBeneficialOwner er alltid med, uavhengig av scope.

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 med nøkkelen. Kallet treng berre scheme og organisasjonsnummeret du allereie har frå selskapsoppslaget.
  3. Bruk svaret

    Filtrer på isUltimateBeneficialOwner for å finne kontrollerande eigar direkte, eller summer share for å sjå heile eigarfordelinga.

Data og kjelder

Norske aksjonærdata kjem frå aksjonærregisteret til Brønnøysundregistrene, oppdatert løpande. Svenske aksjonærdata blir verifiserte mot registeret til Bolagsverket via Combify.

Sjå også

Spørsmål og svar

Kvifor får eg berre fødselsår og ikkje namn på aksjonæren?
Personnamn i aksjonærlista krev scopet owners.read i tillegg til companies.read. Utan det returnerer kallet fødselsår når det er kjent, same avgrensing som blir brukt på eigaroppslaget for ein eigedom.
Kva er reell rettshavar?
Personen som til slutt kontrollerer selskapet, direkte eller gjennom ei eigarkjede, registrert i registeret over reelle rettshavarar hos Brønnøysundregistrene. isUltimateBeneficialOwner flaggar denne aksjonæren direkte i svaret.
Kor ferske er dataa?
Aksjonærregisteret blir halde løpande oppdatert mot Brønnøysundregistrene. Ei eigarendring er synleg i kallet så snart ho er registrert.
Verkar det i Sverige?
Ja. Bruk scheme 0007 og det svenske organisationsnumret, så svarar kallet med same feltsett, verifisert mot registeret til Bolagsverket via Combify.
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!