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, medholder.kindsom skiljer dem. Ingen egen gren att parsa för varje typ.Sedan när, inte bara vem
sinceDatevisar 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.
/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 anger om person eller organization är ifyllt. Utan scopet owners.read returneras bara person.birthYear, aldrig namnet.
Tre steg till första svaret
Logga in med GitHub
Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till den här sidan.Anropa slutpunkten
Byt ut$TOKENi curl-anropet ovan mot nyckeln. Anropet behöver bara scheme och organisationsnummret du redan har från bolagsuppslaget.Använd svaret
Filtrera pårolefö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?
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?
Fungerar det i Sverige?
0007 och det svenska organisationsnummret, då svarar anropet med samma fältuppsättning, verifierat mot Bolagsverkets register via Combify.Vilka rolltyper finns?
role bär själva rolltypen.