Gå til hovedinnhold
NB! 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!

Roller: Hvem sitter i styret?

De registrerte rollene på et selskap: styreleder, daglig leder, revisor og de andre, hver med hvem som innehar rollen og siden når.

Nøkkelen virker på Placepoint API og på dagens Data API, 35 kall om dagen i 14 dager.

Prøv med et ekte selskap: Eksempel Eiendom AS

  • Test på under ett minutt
  • Ett GET-kall
  • Landkode og organisasjonsnummer
  • Norge og Sverige
  • Brønnøysundregistrene-verifisert

Fra organisasjonsnummer til rolleliste​

Kallet svarer på hvem som faktisk styrer selskapet. Kredittvurderere bruker rollelisten til å se hvem som har signeringsrett før en avtale inngås, meglere til å identifisere riktig kontaktperson hos motparten, og compliance-team til å sjekke om en person går igjen i flere selskaper.

Hver rolle har en holder: en person eller et annet selskap. Et selskap som innehar en rolle, for eksempel som revisor, kommer med fullt organisasjonsnummer og navn. En person kommer med fødselsår som standard; fullt navn krever i tillegg scopet person:read, samme avgrensning som eieroppslaget på en eiendom bruker.

sinceDate sier når rollen begynte, så du ser om et styreskifte er ferskt eller har stått uendret i årevis.

  • Ett kall for hele styret

    Alle roller på selskapet kommer i én liste: styreleder, daglig leder, revisor og resten, i stedet for å lete dem opp én og én i et manuelt registeroppslag.
  • Selskap og person i samme skjema

    En revisor som er et selskap og en daglig leder som er en person kommer i samme feltstruktur, med holder.kind som skiller dem. Ingen egen gren å parse for hver type.
  • Siden når, ikke bare hvem

    sinceDate viser hvor lenge en rolle har stått. Et nylig styreskifte er et signal i seg selv, ikke bare hvem som sitter der i dag.

Felter som faktisk sier noe​

Ett GET-kall på selskapets scheme og id gir hele rollelisten. Feltene under er de som avgjør hva du kan lese ut av hver rolle.

GET/companies/{country}/{id}/roles
curl -X GET "https://data.placepoint.no/companies/NO/987654321/roles" \
-H "Authorization: Bearer $TOKEN"

svar · 200

{
"items": [
{
"role": "CHAIR",
"holder": {
"kind": "PERSON",
"person": {
"birthYear": 1975
}
},
"sinceDate": "2019-06-01"
},
{
"role": "CEO",
"holder": {
"kind": "PERSON",
"person": {
"birthYear": 1980
}
},
"sinceDate": "2021-01-15"
},
{
"role": "AUDITOR",
"holder": {
"kind": "ORGANIZATION",
"organization": {
"organizationIdentifier": {
"country": "NO",
"id": "912345678"
},
"name": "Revisor AS",
"country": "NO"
}
},
"sinceDate": "2020-03-01"
}
]
}

Scope: company:readTeknisk referanse og Try-it

Vis alle felt (11)
FeltTypeBeskrivelse
items[].rolestringRole type.
items[].holder.kindstringWhich nested object is populated.
items[].holder.person.namestringFull name.
items[].holder.person.birthYearintegerYear of birth.
items[].holder.organization.organizationIdentifier.countrystringISO 3166-1 alpha-2 country code of the register. NO is Brønnøysundregistrene, SE is Bolagsverket.
items[].holder.organization.organizationIdentifier.idstringRegister identifier.
items[].holder.organization.namestringRegistered name.
items[].holder.organization.countrystringISO 3166-1 alpha-2.
items[].holder.organization.links[].hrefstringAbsolute URL.
items[].holder.organization.links[].titlestringHuman label.
items[].sinceDatestringDate the role began.

holder.kind sier om person eller organization er fylt ut. Uten scopet person:read returneres bare person.birthYear, aldri navnet.

Test på under ett minutt​

  1. Logg inn med GitHub

    Ett klikk, under ett minutt, ingen betalingskort. Nøkkelen kommer tilbake til denne siden.
  2. Kall endepunktet

    Bytt ut $TOKEN i curl-en over med nøkkelen. Kallet trenger bare scheme og organisasjonsnummeret du allerede har fra selskapsoppslaget.
  3. Bruk svaret

    Filtrer på role for å finne styreleder eller daglig leder direkte, eller list alle rollene for en fullstendig oversikt over hvem som styrer selskapet.

Data og kilder​

Norske roller kommer fra Brønnøysundregistrenes Enhetsregister, oppdatert løpende. Svenske roller verifiseres mot Bolagsverkets register via Combify.

Se også​

Spørsmål og svar​

Hvorfor får jeg bare fødselsår og ikke navn på personen?
Personnavn i roller krever scopet person:read i tillegg til company:read. Uten det returnerer kallet fødselsår når det er kjent, samme avgrensning som brukes på eieroppslaget for en eiendom.
Hvor ferske er dataene?
Rollene holdes løpende oppdatert mot Brønnøysundregistrene. Et styreskifte er synlig i kallet så snart det er registrert.
Virker det i Sverige?
Ja. Bruk landkoden SE og det svenske organisationsnumret, så svarer kallet med samme feltsett, verifisert mot Bolagsverkets register via Combify.
Hvilke rolletyper finnes?
Styreleder, styremedlem, daglig leder, revisor og de andre rollene som registreres i Enhetsregisteret. role bærer selve rolletypen.
NB! 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!