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, medholder.kindsom skiller dem. Ingen egen gren å parse for hver type.Siden når, ikke bare hvem
sinceDateviser 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.
/companies/{scheme}/{id}/rolescurl -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"
}
]
}
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
Logg inn med GitHub
Ett klikk, under ett minutt, ingen betalingskort. Nøkkelen kommer tilbake til denne siden.Kall endepunktet
Bytt ut$TOKENi curl-en over med nøkkelen. Kallet trenger bare scheme og organisasjonsnummeret du allerede har fra selskapsoppslaget.Bruk svaret
Filtrer pårolefor å 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?
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?
Virker det i Sverige?
0007 og det svenske organisationsnumret, så svarer kallet med samme feltsett, verifisert mot Bolagsverkets register via Combify.Hvilke rolletyper finnes?
role bærer selve rolletypen.