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

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 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 Eiendom AS

  • Prøvenøkkel med GitHub på under ett minutt
  • Ett GET-kall
  • ISO 6523-identifikatorer
  • Norge og Sverige
  • Brønnøysundregistrene-verifisert

ℹ️ Endepunktet svarer når Placepoint API er lansert. Kontrakten under er endelig; Leietaker-API svarer allerede.

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 owners.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/{scheme}/{id}/roles
curl -X GET "https://data.placepoint.no/companies/0192/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": {
"scheme": "0192",
"id": "912345678"
},
"name": "Revisor AS",
"country": "NO"
}
},
"sinceDate": "2020-03-01"
}
]
}

Scope: companies.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.schemestringISO 6523 ICD code.
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 owners.read returneres bare person.birthYear, aldri navnet.

Tre steg til første svar

  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 owners.read i tillegg til companies.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 scheme 0007 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.
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!