Enhetsregisterets dokumentasjon for åpne data (2.0.0)

Enhetsregisteret

Register over grunndata om juridiske personer og andre enheter. Enhetsregisteret tildeler organisasjonsnummer for entydig identifisering av enheter.

Organisasjonsnummer

Nisifret nummer som entydig identifiserer enheter i Enhetsregisteret.

Enhet

Enhet på øverste nivå i registreringsstrukturen i Enhetsregisteret.
Eksempelvis enkeltpersonforetak, foreninger, selskap, sameier og andre som er registrert i Enhetsregisteret.
Identifiseres med organisasjonsnummer.

Underenhet

Enhet på laveste nivå i registreringsstrukturen i Enhetsregisteret.
En underenhet kan ikke eksistere alene og har alltid knytning til en hovedenhet.
Identifiseres med organisasjonsnummer.

Organisasjonsform

Organisasjonsform er virksomhetens formelle organisering og gir retningslinjer overfor blant annet ansvarsforhold, skatt, revisjonsplikt, rettigheter og plikter.

Næringskode

Noen virksomheter har både ordinær næringskode og en hjelpeenhetskode.
I disse tilfellene bør de ordinære næringskodene presenteres først med kode og tekst.
Deretter vises hjelpeenhetskoden som tekst, uten kode - med tillegg av teksten "Yter tjenester til eget konsern".

Eksempel:

11.050 Produksjon av øl
11.070 Produksjon av mineralvann, leskedrikker og annet vann på flaske

Engroshandel med drikkevarer ellers:
Yter tjenester til eget konsern

Se Næringskoder på brreg.no
Standard for næringsgruppering finner du på ssb.no

Kommune og geografisk områdeinndeling

Enhetens forretningsadresse, postadresse eller beliggenhetsadresse er knyttet til en kommune eller en geografisk områdeinndeling.
Fra 1. januar 2019 vil områdene Spitsbergen, Bjørnøya og Hopen inngå i den geografiske områdeinndelingen Svalbardområde, med kode 2100.

Oversikt over kommuner og geografiske områdeinndelinger finner du på Standard for kommuneinndeling og Standard for regionale spesialkoder fra SSB.

Matrikkelenhet

Et objekt som er registrert som en enhet i matrikkelen.
Slike matrikkelenheter er først og fremst grunneiendommer, betegnet ved gårds- og bruksnummer, eierseksjoner eller festegrunn.

Hjelpeenhet

Hjelpeenheter er enheter som bare yter konsern- eller foretaksinterne tjenester og som skal næringskodes lik enheten(e) de yter tjenester til.
De tildeles en alternativ næringskode - hjelpeenhetskode - som viser hvilken type tjeneste som utføres.

Rolle

Med roller menes relasjoner en enhet kan ha til fysiske personer eller andre enheter i Enhetsregisteret.

Rolletype

Kodeliste/enum.
Rolletype beskriver rolle-objektet ytterligere.
Feltene i objektet kan variere for forskjellige rolletyper.

Eksempler:

INNH (innehaver) registreres som person med fødselsdato på et enkeltpersonforetak.
REVI (revisor) registreres som enhet med organisasjonsnummer.

Rollegruppe

En rollegruppe er en logisk samling av roller, som kan grupperes sammen.

Rollegruppetype

Kodeliste/enum.
En rollegruppetype forteller hvilke roller som ligger under en rollegruppe.

For eksempel:

STYRE er en rollegruppe for disse rollene: Styrets leder, nestleder, styremedlem, varamedlem og observatør.

Representant

Kodeliste/enum.
Representant viser hvem vedkommende representerer i styret. Det kan være enten de ansatte, A-, B- eller C-aksjonærer.

De fleste tjenestene svarer med JSON, på HAL formatet (Hypertext Application Language). Unntaket er nedlastingstjenestene, som resulterer i GZIP-komprimert JSON uten HAL.

Se mer om versjonering i seksjonen om Versjonering.

404 Ikke funnet

Dersom du sender en forespørsel på et endepunkt der ressurs ikke finnes, selv om forespørselen er gyldig, får du en respons med status 404 og uten innhold.

400 Ugyldig forespørsel

Alle endepunktene har felles validering for parametere.
Dersom en eller flere parametere har ugyldig verdi, får du en respons med statuskode 400.
Alle ugyldige parametere vil listes ut, med forklaring på hvorfor.
Under ser du eksempel på 400 respons, med ugyldig verdi for organisasjonsnummer.

   HTTP/1.1 400 Bad Request
   Vary: Origin
   Vary: Access-Control-Request-Method
   Vary: Access-Control-Request-Headers
   Content-Type: application/json
   Content-Length: 367
   {
     "tidsstempel" : 1622200011303,
     "status" : 400,
     "feilmelding" : "Feilaktig forespørsel",
     "sti" : "/enhetsregisteret/api/enheter/9ECD01011/roller",
     "antallFeil" : 1,
     "valideringsfeil" : [ {
       "feilmelding" : "Organisasjonsnummer må være et nummer med nøyaktig 9 siffer",
       "parametere" : [ "9ECD01011" ],
       "feilaktigVerdi" : "9ECD01011"
     } ]
   }
   

500 Feil på server

Alle endepunktene har felles feilhandtering for uventede feil. Hvis det skulle oppstå en feil, så vil du få en respons med statuskode 500.
Hvis du ønsker å rapportere feilen til oss, så er det fint om du også sender oss trace fra responsen. Dette er en UUID som gjør at vi lettere kan finne frem loggene fra forespørselen som feilet.
Under ser du et eksempel på en 500 respons:

   HTTP/1.1 500 Internal Server Error
   Vary: Origin
   Vary: Access-Control-Request-Method
   Vary: Access-Control-Request-Headers
   Content-Type: application/json
   Content-Length: 257 
   {
     "timestamp" : "2021-05-28T11:34:33.435+0000",
     "status" : 500,
     "error" : "Internal Server Error",
     "message" : "Internal Server Error",
     "path" : "/enhetsregisteret/api/enheter/999999999/roller",
     "trace" : "5631709a-6e3e-4b72-94e7-fcbf6341272a"
   }
   

3. november 2024

Endepunkt

/api/enheter
/api/enheter/{orgnr}
/api/enheter/lastned
/api/enheter/lastned/regneark
/api/underenheter
/api/underenheter/{orgnr}
/api/underenheter/lastned
/api/underenheter/lastned/regneark

Endringer

• Fjern V1 fra søk and totalbestand endepunkter.

3. oktober 2024

Endepunkt

/api/enheter
/api/underenheter
/partiregisteret/api/lastned/csv
/frivillighetsregisteret/api/lastned/csv

Endringer

• Legg til nye responsfelter i json, csv, excel and api
  • /api/enheter:
    • epostadresse
    • telefon
    • mobil
    • registreringsdatoForetaksregisteret
    • registreringsdatoFrivillighetsregisteret
    • registreringsdatoMerverdiavgiftsregisteret
    • registreringsdatoMerverdiavgiftsregisteretEnhetsregisteret
    • registreringsdatoFrivilligMerverdiavgiftsregisteret
    • registreringsdatoPartiregisteret
    • registrertIPartiregisteret
    • registreringsdatoAntallAnsatteNAVAaregisteret
    • registreringsdatoAntallAnsatteEnhetsregisteret
  • /api/underenheter
    • epostadresse
    • telefon
    • mobil
    • registreringsdatoMerverdiavgiftsregisteret
    • registreringsdatoMerverdiavgiftsregisteretEnhetsregisteret
    • registreringsdatoFrivilligMerverdiavgiftsregisteret
    • registreringsdatoAntallAnsatteNAVAaregisteret
    • registreringsdatoAntallAnsatteEnhetsregisteret
• Legg til nye query-parametere
  • /api/enheter:
    • "fraRegistreringsdatoMerverdiavgiftsregisteret". Filtrer enheter på tidligste registreringsdato i Merverdiavgiftsregisteret.
    • "tilRegistreringsdatoMerverdiavgiftsregisteret". Filtrer enheter på seneste registreringsdato i Merverdiavgiftsregisteret.
    • "fraRegistreringsdatoForetaksregisteret". Filtrer enheter på tidligste registreringsdato i Foretaksregisteret.
    • "tilRegistreringsdatoForetaksregisteret". Filtrer enheter på seneste registreringsdato i Foretaksregisteret.
    • "fraRegistreringsdatoFrivillighetsregisteret". Filtrer enheter på tidligste registreringsdato i Frivillighetsregisteret.
    • "tilRegistreringsdatoFrivillighetsregisteret". Filtrer enheter på seneste registreringsdato i Frivillighetsregisteret.
    • "fraRegistreringsdatoPartiregisteret". Filtrer enheter på tidligste registreringsdato i Partiregisteret.
    • "tilRegistreringsdatoPartiregisteret". Filtrer enheter på seneste registreringsdato i Partiregisteret.
    • "registrertIPartiregisteret": Filtrer enheter på om de er registrert i Partiregisteret.
  • /api/underenheter:
    • "fraRegistreringsdatoMerverdiavgiftsregisteret". Filtrer underenheter på tidligste registreringsdato i Merverdiavgiftsregisteret.
    • "tilRegistreringsdatoMerverdiavgiftsregisteret". Filtrer underenheter på seneste registreringsdato i Merverdiavgiftsregisteret.
• Legg til nye endepunkt for nedlastning av totalbestand
  • /partiregisteret/api/lastned/csv
  • /frivillighetsregisteret/api/lastned/csv
    • Totalbestand fra Frivillighetsregisteret er bare midlertidig tilgjengelig og vil bli erstattet av en ny tjeneste i løpet av våren/høsten 2025.

4. juli 2024

Endepunkt

/enheter/lastned/csv
/underenheter/lastned/csv

Endringer

• Erstatt /n med linjeskift i forretningsadresse.adresse, beliggenhetsadresse.adresse og postadresse.adresse

17. juni 2024

Endepunkt

/autorisert-api/enheter/{orgnr}/roller

Endringer

• Nytt endepunkt for uthenting av roller som inkluderer fødselsnummer. Dette endepunktet er sikret med Maskinporten. Les mer om dette.

4. januar 2024

Endepunkt

/api/enheter
/api/underenheter

Endringer

Nytt i versjon 1

• Legg til nye query-parametere
  • "forretningsadresse.kommunenummer". Filtrer enheter på bare forretningsadresse.
  • "beliggenhetsadresse.kommunenummer". Filtrer underenheter på bare beliggenhetsadresse.

Nytt i versjon 2:

• Legg til nye query-parametere
  • "forretningsadresse.kommunenummer". Filtrer enheter på bare forretningsadresse.
  • "beliggenhetsadresse.kommunenummer". Filtrer underenheter på bare beliggenhetsadresse.
• Endre query-parametere
  • kommunenummer
  • Før: Filtrer enheter/underenheter på forretningsadresse/beliggenhetsadresse
  • Nå: Filtrer enheter/underenheter på kommunenummer i postadresse <strong>eller</strong> forretningsadresse/beliggenhetsadresse.

21. november 2023

Endepunkt

/api/enheter
/api/enheter/{orgnr}
/api/enheter/lastned
/api/enheter/lastned/csv
/api/enheter/lastned/regneark

Endringer

Nytt i versjon 2:

• Legg til nye felter i json, csv, excel og api
  • underAvviklingDato
  • tvangsavvikletPgaManglendeSlettingDato
  • tvangsopplostPgaManglendeDagligLederDato
  • tvangsopplostPgaManglendeRevisorDato
  • tvangsopplostPgaManglendeRegnskapDato
  • tvangsopplostPgaMangelfulltStyreDato

13. september 2023

Endepunkt

/api/enheter
/api/enheter/{orgnr}
/api/enheter/lastned
/api/enheter/lastned/csv
/api/enheter/lastned/regneark
/api/underenheter
/api/underenheter/{orgnr}
/api/underenheter/lastned
/api/underenheter/lastned/csv
/api/underenheter/lastned/regneark

Endringer

Endre celler i csv filer til å inneholde fullstendige verdier:

• postadresse, forretningsadresse og frivilligMvaRegistrertBeskrivelser for hovedenhet
• postadresse, beliggenhetsadresse og frivilligMvaRegistrertBeskrivelser for underenhet

Innført versjon 2:

• Endre query-parametere "fraAntallAnsatte" og "tilAntallAnsatte". Det er ikke mulig å søke med tall mellom 1-4. Det gir nå 400
• Endre antallAnsatte. Feltet er ikke lenger obligatorisk og vil være null når virksomheten har mellom 0-4 ansatte
• Innfør nye felt
  • harRegistrertAntallAnsatte. Feltet er innført for å kompensere for endringen på antallAnsatte
  • hjelpeenhetskode
  • hjelpeenhetskode.kode
  • hjelpeenhetskode.beskrivelse
• Fjern felter
  • naeringskode1.hjelpeenhetskode
  • naeringskode2.hjelpeenhetskode
  • naeringskode3.hjelpeenhetskode
• Legg anførselstegn rundt filnavn i content-disposition header for alle fil nedlastninger

Innført i versjon 2 for enheter:

• Legg til nye felter i json, csv, excel og api
  • konkursdato
  • vedtektsdato
  • vedtektsfestetFormaal
  • aktivitet

27. juli 2023

Endepunkt

/api/enheter/lastned/csv
/api/underenheter/lastned/csv

Endringer

Innfør totalbestand på CSV format

Vi vil forsøke, så langt det lar seg gjøre å ikke bryte bakoverkompatibiliteten med våre brukere. Likevel kan det være nødvendig i enkelte situasjoner, av for eksempel juridiske årsaker eller vedlikehold å gjøre endringer som medfører et slikt brudd.

Vi vil i dette tilfellet versjonere tjenesten slik at nyeste versjon vil være tilgjengelig sammen med forrige versjon. Dersom man ikke benytter versjonering i accept header, vil man få siste versjon.

Eldre versjon vil anses som utdatert/deprecated, og vil på sikt bli tatt bort. Ved behov for denne typen endringer vil vi forsøke å gi bruker god tid, og varsle om endringen i forkant.

Når innføres det en ny versjon?

Vi vil innføre en ny versjon når vi introduserer en endring som påvirker bakoverkompatibiliteten. Mindre endringer og patcher vil ikke medføre versjonsendring i header.

Eksempel på endring som medfører versjonering:

• Fjerne eller endre navn på et attributt i HTTP-responsen.
• Fjerne eller endre navn på et REST endepunkt.

Når fjernes en versjon?

Vi vil legge ut varsel/driftsmeldinger i god tid på https://www.brreg.no/om-oss/driftsmeldinger/. I tillegg kan du abonnere på en RSS-feed (https://www.brreg.no/produkter-og-tjenester/rss-feed/)

Hvordan velger jeg versjon?

Du kan velge versjon ved å spesifisere HTTP Accept-headeren. Bruk headeren spesifisert i denne tabellen.

Om du ikke spesifiserer Accept-header, vil du automatisk få den seneste versjonen etter 11. mars 2024.

Det er mulig i de fleste endepunkter å bla gjennom resultatsettet via page+size, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000. Ved oppslag på større enn 10 000 vil tjenesten returnere HTTP-status 400 med tilhørende feilmelding.

Dersom formålet med å bla dypt i tjenesten er å hente ut alle enheter, kan man i stedet benytte nedlastingstjenestene. Se kapittel om vedlikehold av kopi. Disse oppdateres en gang i døgnet. For å oppdatere enhetene kan man benytte oppdateringstjenesten, og videre gjøre enkeltoppslag på enhetene som har fått en endring.

For å vedlikeholde en kopi av enhetsregisteret, er det følgende løp vi har lagt opp til:

• Last ned totalbestand for enheter

• Last ned totalbestand for underenheter

• Last ned totalbestand for roller

PS! Filene produseres hver natt, cirka klokken 0500.

• Du kan for eksempel lagre eller indeksere et utvalg objekter i din egen database.

PS! Totalbestand filene er store og får nok ikke plass i minnet på en gang. Vi anbefaler å benytte en strømmefunksjon for å lese fila litt etter litt.

• Hent oppdateringer for enheter

• Hent oppdateringer for underenheter

• Hent oppdateringer for roller

PS! Du kan starte kopieringsjobben din fra en tidlig id eller et tidspunkt i god tid før totalbestanden er produsert. Da sikrer du at du får du med deg alle endringene!

Hvis det har kommet nye oppdateringer fra sist gang du oppdaterte, hent hele objektet på nytt:

• Hent enheter

• Hent underenheter

• Hent roller

Uthenting av roller med fødselsnummer er beskyttet av autentisering mot maskinporten.

For å benytte dette apiet må du ha en klient i maskinporten som har ett av disse to scopene:

1. brreg:data:enhetsregisteret:roller
2. brreg:data:enhetsregisteret:auto:roller

Er du en virksomhet i offentlig sektor (STAT, KOMM, FYLK, ORGL og ADOS), så har du allerede fått tildelt rettighet til å bruke scopet brreg:data:enhetsregisteret:auto:roller.

Alle andre må søke om tilgang ved å sende en epost til opendata@brreg.no og vil få tildelt bruksrettighet for scopet brreg:data:enhetsregisteret:roller om vi godkjenner tilgangen.

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 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 på spørring i curl:

curl -v -X GET -H "Authorization: Bearer $SIGNED_JWT_TOKEN" \
   https://data.brreg.no/enhetsregisteret/autorisert-api/enheter/123456789/roller

Klikk her for å se mer informasjon om endepunktet.

Generelle endepunkt

Operasjoner mot enhetsregisteret for hovedenheter

Operasjoner mot enhetsregisteret for underenheter

Operasjoner mot roller i enhetsregisteret

Operasjoner mot kommuner i enhetsregisteret