# Brønnøysundregistrene Roller API

**Canonical:** https://apis.io/apis/brreg-no/brreg-no-roller-api/  
**Provider:** Brønnøysundregistrene — https://apis.io/providers/brreg-no/  
**Base URL:** https://data.brreg.no  
**Documentation:** https://data.brreg.no/enhetsregisteret/api/docs/index.html

Brønnøysundregistrene Roller API is one of 14 APIs that [Brønnøysundregistrene](https://apis.io/providers/brreg-no/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include roller. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Noen endepunkt for uthenting av roller er beskyttet av autentisering mot maskinporten. ### Scopes Ulike endepunkter krever ulike scopes: #### Rolleutskrift-endepunktet Endepunktet [/autorisert-api/personer/rolleutskrift](#tag/roller/operation/hentRolleutskriftForPerson) krever scopet: - `brreg:data:enhetsregisteret:roller:person:oppslag:fnr` Alle offentlige og private virksomheter kan søke om tilgang. #### Roller-endepunkter med fødselsnummer for private aktører Endepunktene [/autorisert-api/enheter/{orgnr}/roller](#tag/roller/operation/hentRollerMedFnr) og [/autorisert-api/roller/totalbestand](#tag/roller/operation/lastnedRollerTotalbestandMedPid) krever scopet: - `brreg:data:enhetsregisteret:roller` Kredittopplysningsforetak og finansforetak kan søke om tilgang. #### Roller-endepunkter med fødselsnummer for offentlige aktører Endepunktene [/autorisert-api/enheter/{orgnr}/roller](#tag/roller/operation/hentRollerMedFnr) og [/autorisert-api/roller/totalbestand](#tag/roller/operation/lastnedRollerTotalbestandMedPid) krever scopet: - `brreg:data:enhetsregisteret:auto:roller` Offentlig sektor (STAT, KOMM, FYLK, ORGL og ADOS) har automatisk tilgang til scopet. ### Søke om tilgang Sende en epost til opendata@brreg.no med følgende info: - organisasjonsnummer - navn på virksomheten - hvilket scope man ønsker tilgang til ### Autentisering Husk at selv om du har fått rettigheten til å bruke ett av scopene, så må du også legge scopet til din egen klient i maskinporten. [Les her](https://docs.digdir.no/docs/Maskinporten/maskinporten_virksomhetssertifikat#autentiseringsmetoder-i-maskinporten) hvordan man kan autentisere seg med maskinporten. Kall mot apiet for uthenting av roller med fødselsnummer krever at du sender inn en JWT signert med en av de to autentiseringsmåtene beskrevet i linken ovenfor. Du må også sette resource claim i JWT grant til `https://data.brreg.no/enhetsregisteret/autorisert-api` før man signerer den og sender over til https://maskinporten.no. I preprod-miljøet må denne settes til `https://data.ppe.brreg.no/enhetsregisteret/autorisert-api`. Når man skal bruke preprod-miljøet så må man bruke `https://test.maskinporten.no` for å lage token. Bearer token må være en JWT signert av enten virksomhetssertifikat eller assymetrisk nøkkel. ### Eksempel ```bash curl -v -X GET -H "Authorization: Bearer $SIGNED_JWT_TOKEN" \ https://data.brreg.no/enhetsregisteret/autorisert-api/enheter/123456789/roller ```

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/enhetsregisteret/api/enheter/{enhetorgnr}/roller` | Hent alle roller for en enhet |
| GET | `/enhetsregisteret/autorisert-api/enheter/{enhetorgnr}/roller` | Hent alle roller for en enhet, inkludert fødselsnummer for personer |
| GET | `/enhetsregisteret/api/roller/totalbestand` | Last ned totalbestand av roller som zippet json |
| GET | `/enhetsregisteret/autorisert-api/roller/totalbestand` | Last ned totalbestand av roller med fødselsnummer som zippet json |
| POST | `/enhetsregisteret/autorisert-api/personer/rolleutskrift` | Hent rolleutskrift for en person basert på fødselsnummer |
| GET | `/enhetsregisteret/api/roller/representanter` | Hent alle rollerepresentanter |
| GET | `/enhetsregisteret/api/roller/rollegruppetyper` | Hent alle rollegruppetyper |
| GET | `/enhetsregisteret/api/roller/rolletyper` | Hent alle rolletyper |
| GET | `/enhetsregisteret/api/roller/enheter/{enhetorgnr}/juridiskeroller` | Hent alle roller en virksomhet har i andre virksomheter |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/brreg-no/openapi/brreg-no-roller-api-openapi.yml
- **Documentation** — https://data.brreg.no/enhetsregisteret/api/docs/index.html
- **Documentation** — https://data.brreg.no/regnskapsregisteret/regnskap/swagger-ui/index.html

## Other Brønnøysundregistrene APIs (12)

- [Brønnøysundregistrene Enheter API](https://apis.io/apis/brreg-no/brreg-no-enheter-api/)
- [Brønnøysundregistrene Frivillighetsregisteret API](https://apis.io/apis/brreg-no/brreg-no-frivillighetsregisteret-api/)
- [Brønnøysundregistrene Generelt API](https://apis.io/apis/brreg-no/brreg-no-generelt-api/)
- [Brønnøysundregistrene Kommuner API](https://apis.io/apis/brreg-no/brreg-no-kommuner-api/)
- [Brønnøysundregistrene Kopi av årsregnskap API](https://apis.io/apis/brreg-no/brreg-no-kopi-av-rsregnskap-api/)
- [Brønnøysundregistrene Matrikkelenheter API](https://apis.io/apis/brreg-no/brreg-no-matrikkelenheter-api/)
- [Brønnøysundregistrene Mellombalanse API](https://apis.io/apis/brreg-no/brreg-no-mellombalanse-api/)
- [Brønnøysundregistrene Oppdateringer API](https://apis.io/apis/brreg-no/brreg-no-oppdateringer-api/)
- [Brønnøysundregistrene Organisasjonsformer API](https://apis.io/apis/brreg-no/brreg-no-organisasjonsformer-api/)
- [Brønnøysundregistrene Partiregisteret API](https://apis.io/apis/brreg-no/brreg-no-partiregisteret-api/)
- [Brønnøysundregistrene Regnskapsregisteret API](https://apis.io/apis/brreg-no/brreg-no-regnskapsregisteret-api/)
- [Brønnøysundregistrene Statistikk API](https://apis.io/apis/brreg-no/brreg-no-statistikk-api/)

## Tags

roller

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brreg-no/brreg-no-roller-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brreg-no/.