Brønnøysundregistrene Roller API
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
3 of 9 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file