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!

Who owns the company?

The shareholder list for a company: every shareholder with ownership share, share class and who the beneficial owner is, not just who sits at the top of the chain.

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 company: Eksempel Eiendom AS

  • Trial key with GitHub in under a minute
  • One GET call
  • ISO 6523 identifiers
  • Norway and Sweden
  • Brønnøysundregistrene verified

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

From organisation number to ownership picture

The call tells you who actually owns the company. Banks use the shareholder list to know the counterparty before a credit decision, agents use it to see whether a sales mandate involves several owners who have to agree, and compliance teams use it to identify who ultimately holds control.

Each entry is a person or another company, with the ownership share as a fraction, the share class and the number of shares. An organisation comes with a full organisation number and name. A person comes with a year of birth by default; the full name also requires the owners.read scope, the same limit that the owner lookup on a property uses.

isUltimateBeneficialOwner flags a shareholder registered as a beneficial owner, that is, the person who ultimately controls the company, however many steps the ownership passes through.

  • Beneficial owner in the same call

    isUltimateBeneficialOwner answers directly who ultimately controls the company, without you having to follow the ownership chain upwards manually through several company lookups.
  • Ownership as a fraction, not a percentage rounded away

    share.numerator and share.denominator give the exact ownership share. A rounded percentage in a manual lookup hides the difference between 49.9% and 50.1%.
  • Company and person in the same list

    A shareholder that is a holding company and a shareholder that is a person come in the same list, with kind separating them. No separate list to merge yourself.

Fields that actually tell you something

One GET call on the company's scheme and id gives you the whole shareholder register. The fields below are the ones that decide what you can read out of each shareholder.

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.

Without the owners.read scope, only person.birthYear is returned for a person shareholder, never the name. isUltimateBeneficialOwner is always included, whatever the scope.

Three steps to your first response

  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. The call only needs the scheme and the organisation number you already have from the company lookup.
  3. Use the response

    Filter on isUltimateBeneficialOwner to find the controlling owner directly, or sum share to see the full ownership split.

Data and sources

Norwegian shareholder data comes from the Brønnøysundregistrene shareholder register, updated continuously. Swedish shareholder data is verified against the Bolagsverket register via Combify.

See also

Questions and answers

Why do I only get a year of birth and not the shareholder's name?
Personal names in the shareholder list require the owners.read scope in addition to companies.read. Without it, the call returns the year of birth where it is known, the same limit that applies to the owner lookup for a property.
What is a beneficial owner?
The person who ultimately controls the company, either directly or through an ownership chain, registered in the Brønnøysundregistrene register of beneficial owners. isUltimateBeneficialOwner flags this shareholder directly in the response.
How fresh is the data?
The shareholder register is kept continuously updated against Brønnøysundregistrene. An ownership change is visible in the call as soon as it is registered.
Does it work in Sweden?
Yes. Use scheme 0007 and the Swedish organisationsnummer, and the call responds with the same set of fields, verified against the Bolagsverket register 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!