Roller: Kven sit i styret?

Dei registrerte rollene på eit selskap: styreleiar, dagleg leiar, revisor og dei andre, kvar med kven som innehar rolla og sidan når.

Logg inn med GitHubSlik ser det ut ↓Teknisk referanse →

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 eitt minutt
• Eitt GET-kall
• Landkode og organisasjonsnummer
• Noreg og Sverige
• Brønnøysundregistrene-verifisert

Frå organisasjonsnummer til rolleliste

Kallet svarar på kven som faktisk styrer selskapet. Kredittvurderarar bruker rollelista til å sjå kven som har signeringsrett før ein avtale blir inngått, meklarar til å identifisere rett kontaktperson hos motparten, og compliance-team til å sjekke om ein person går igjen i fleire selskap.

Kvar rolle har ein holder: ein person eller eit anna selskap. Eit selskap som innehar ei rolle, til dømes som revisor, kjem med fullt organisasjonsnummer og namn. Ein person kjem med fødselsår som standard; fullt namn krev i tillegg scopet person:read, same avgrensinga som eigaroppslaget på ein eigedom bruker.

sinceDate seier når rolla begynte, så du ser om eit styreskifte er ferskt eller har stått uendra i årevis.

• Eitt kall for heile styret

  Alle roller på selskapet kjem i éi liste: styreleiar, dagleg leiar, revisor og resten, i staden for å leite dei opp éin og éin i eit manuelt registeroppslag.

• Selskap og person i same skjema

  Ein revisor som er eit selskap og ein dagleg leiar som er ein person kjem i same feltstruktur, med holder.kind som skil dei. Ingen eigen grein å parse for kvar type.

• Sidan når, ikkje berre kven

  sinceDate viser kor lenge ei rolle har stått. Eit nyleg styreskifte er eit signal i seg sjølv, ikkje berre kven som sit der i dag.

Felt som faktisk seier noko

Eitt GET-kall på selskapet sitt scheme og id gir heile rollelista. Felta under er dei som avgjer kva du kan lese ut av kvar 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)

Felt	Type	Beskrivelse
items[].role	string	Role type.
items[].holder.kind	string	Which nested object is populated.
items[].holder.person.name	string	Full name.
items[].holder.person.birthYear	integer	Year of birth.
items[].holder.organization.organizationIdentifier.country	string	ISO 3166-1 alpha-2 country code of the register. NO is Brønnøysundregistrene, SE is Bolagsverket.
items[].holder.organization.organizationIdentifier.id	string	Register identifier.
items[].holder.organization.name	string	Registered name.
items[].holder.organization.country	string	ISO 3166-1 alpha-2.
items[].holder.organization.links[].href	string	Absolute URL.
items[].holder.organization.links[].title	string	Human label.
items[].sinceDate	string	Date the role began.

holder.kind seier om person eller organization er fylt ut. Utan scopet person:read blir berre person.birthYear returnert, aldri namnet.

Test på under eitt minutt

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å role for å finne styreleiar eller dagleg leiar direkte, eller list alle rollene for ei fullstendig oversikt over kven som styrer selskapet.

Data og kjelder

Norske roller kjem frå Brønnøysundregistrene sitt Enhetsregister, oppdatert løpande. Svenske roller blir verifiserte mot Bolagsverket sitt register via Combify.

Sjå òg

• Selskapspanel
• Eigarstruktur-rapporten
• Teknisk referanse
• Placepoint API

Spørsmål og svar

Kvifor får eg berre fødselsår og ikkje namn på personen?

Personnamn i roller krev scopet person:read i tillegg til company:read. Utan det returnerer kallet fødselsår når det er kjent, same avgrensinga som blir brukt på eigaroppslaget for ein eigedom.

Kor ferske er dataa?

Rollene blir haldne løpande oppdaterte mot Brønnøysundregistrene. Eit styreskifte er synleg i kallet så snart det er registrert.

Verkar det i Sverige?

Ja. Bruk landkoden SE og det svenske organisationsnumret, så svarar kallet med same feltsett, verifisert mot Bolagsverket sitt register via Combify.

Kva rolletypar finst?

Styreleiar, styremedlem, dagleg leiar, revisor og dei andre rollene som blir registrerte i Enhetsregisteret. role ber sjølve rolletypen.

Sjå kven som sit i styret

Eitt GET-kall gir alle roller på eit selskap, med kven som innehar dei og sidan når. Logg inn med GitHub øvst på sida for å prøve det i dag, eller ta kontakt for tilgang til heile landet.

Logg inn med GitHub