Roles: Who sits on the board?

The registered roles at a company: Chair of the Board, managing director, auditor and the rest, each with who holds the role and since when.

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 company: Eksempel Eiendom AS

• Test in under a minute
• One GET call
• Country code and organisation number
• Norway and Sweden
• Verified against Brønnøysundregistrene

From organisation number to role list

The call answers who actually runs the company. Credit assessors use the role list to see who has signing authority before an agreement is made, agents use it to identify the right contact person at the counterparty, and compliance teams use it to check whether a person recurs across several companies.

Each role has a holder: a person or another company. A company that holds a role, for example as auditor, comes with a full organisation number and name. A person comes with a year of birth by default; the full name also requires the person:read scope, the same restriction that the owner lookup on a property uses.

sinceDate states when the role started, so you can see whether a change on the board is recent or has stood unchanged for years.

• One call for the whole board

  All roles at the company come in a single list: Chair of the Board, managing director, auditor and the rest, instead of looking them up one by one in a manual register search.

• Company and person in the same schema

  An auditor that is a company and a managing director who is a person come in the same field structure, with holder.kind telling them apart. No separate branch to parse for each type.

• Since when, not just who

  sinceDate shows how long a role has stood. A recent change on the board is a signal in itself, not just who sits there today.

Fields that actually say something

One GET call on the company's scheme and id gives you the whole role list. The fields below are the ones that decide what you can read out of each role.

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 states whether person or organization is filled in. Without the person:read scope, only person.birthYear is returned, never the name.

Test in under a minute

1. Log in with GitHub

   One click, under a minute, no payment card. The key comes back to this page.

2. Call the endpoint

   Replace $TOKEN in the curl above with your key. The call only needs the scheme and the organisation number you already have from the company lookup.

3. Use the response

   Filter on role to find the Chair of the Board or the managing director directly, or list all the roles for a full overview of who runs the company.

Data and sources

Norwegian roles come from Brønnøysundregistrene's Enhetsregisteret (the Central Coordinating Register for Legal Entities), updated continuously. Swedish roles are verified against Bolagsverket's register via Combify.

See also

• Company panel
• The Ownership structure report
• Technical reference
• Placepoint API

Questions and answers

Why do I only get a year of birth and not the person's name?

Personal names in roles require the person:read scope in addition to company:read. Without it, the call returns the year of birth where known, the same restriction used on the owner lookup for a property.

How fresh is the data?

The roles are kept continuously updated against Brønnøysundregistrene. A change on the board is visible in the call as soon as it has been registered.

Does it work in Sweden?

Yes. Use the country code SE and the Swedish organisationsnummer, and the call responds with the same field set, verified against Bolagsverket's register via Combify.

Which role types exist?

Chair of the Board, board member, managing director, auditor and the other roles registered in Enhetsregisteret. role carries the role type itself.

See who sits on the board

One GET call gives you all roles at a company, with who holds them and since when. Log in with GitHub at the top of the page to try it today, or get in touch for access to the whole country.

Logg inn med GitHub