Hoppa till huvudinnehåll
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!

Vilka sitter i styrelsen?

De registrerade rollerna i ett bolag: styrelseordförande, verkställande direktör, revisor och de övriga, var och en med vem som innehar rollen och sedan 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

  • Provnyckel med GitHub på under en minut
  • Ett GET-anrop
  • ISO 6523-identifikatorer
  • Norge och Sverige
  • Brønnøysundregistrene-verifierat

ℹ️ Slutpunkten svarar när Placepoint API är lanserat. Kontraktet nedan är slutgiltigt, Hyresgäst-API svarar redan.

Från organisationsnummer till rollista

Anropet svarar på vem som faktiskt styr bolaget. Kreditbedömare använder rollistan för att se vem som har firmateckningsrätt innan ett avtal ingås, mäklare för att identifiera rätt kontaktperson hos motparten, och compliance-team för att kontrollera om en person återkommer i flera bolag.

Varje roll har en holder: en person eller ett annat bolag. Ett bolag som innehar en roll, till exempel som revisor, kommer med fullständigt organisationsnummer och namn. En person kommer med födelseår som standard, fullständigt namn kräver dessutom scopet owners.read, samma avgränsning som ägaruppslaget på en fastighet använder.

sinceDate anger när rollen började, så du ser om ett styrelsebyte är färskt eller har stått oförändrat i åratal.

  • Ett anrop för hela styrelsen

    Alla roller i bolaget kommer i en lista: styrelseordförande, verkställande direktör, revisor och resten, i stället för att leta upp dem en och en i ett manuellt registeruppslag.
  • Bolag och person i samma schema

    En revisor som är ett bolag och en verkställande direktör som är en person kommer i samma fältstruktur, med holder.kind som skiljer dem. Ingen egen gren att parsa för varje typ.
  • Sedan när, inte bara vem

    sinceDate visar hur länge en roll har stått. Ett nyligen genomfört styrelsebyte är en signal i sig, inte bara vem som sitter där i dag.

Fält som faktiskt säger något

Ett GET-anrop på bolagets scheme och id ger hela rollistan. Fälten nedan är de som avgör vad du kan läsa ut av varje roll.

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 anger om person eller organization är ifyllt. Utan scopet owners.read returneras bara person.birthYear, aldrig namnet.

Tre steg till första svaret

  1. Logga in med GitHub

    Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till den här sidan.
  2. Anropa slutpunkten

    Byt ut $TOKEN i curl-anropet ovan mot nyckeln. Anropet behöver bara scheme och organisationsnummret du redan har från bolagsuppslaget.
  3. Använd svaret

    Filtrera på role för att hitta styrelseordförande eller verkställande direktör direkt, eller lista alla roller för en fullständig överblick över vem som styr bolaget.

Data och källor

Norska roller kommer från Brønnøysundregistrenes Enhetsregister, uppdaterat löpande. Svenska roller verifieras mot Bolagsverkets register via Combify.

Se även

Frågor och svar

Varför får jag bara födelseår och inte namn på personen?
Personnamn i roller kräver scopet owners.read utöver companies.read. Utan det returnerar anropet födelseår när det är känt, samma avgränsning som används på ägaruppslaget för en fastighet.
Hur färska är uppgifterna?
Rollerna hålls löpande uppdaterade mot Brønnøysundregistrene. Ett styrelsebyte syns i anropet så snart det är registrerat.
Fungerar det i Sverige?
Ja. Använd scheme 0007 och det svenska organisationsnummret, då svarar anropet med samma fältuppsättning, verifierat mot Bolagsverkets register via Combify.
Vilka rolltyper finns?
Styrelseordförande, styrelsemedlem, verkställande direktör, revisor och de övriga rollerna som registreras i Enhetsregisteret. role bär själva rolltypen.
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!