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 01.01.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"
   }
   

04.01.2024

Endepunkt

/enheter
/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.11.2023

Endepunkt

/enheter
/enheter/{orgnr}
/enheter/lastned
/enheter/lastned/csv
/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.09.2023

Endepunkt

/enheter
/enheter/{orgnr}
/enheter/lastned
/enheter/lastned/csv
/enheter/lastned/regneark
/underenheter
/underenheter/{orgnr}
/underenheter/lastned
/underenheter/lastned/csv
/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.07.2023

Endepunkt

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

Endringer

Innfør totalbestand på CSV format

Vi har innnført endringer på noen av endepunktene som ikke er bakoverkompatible, og vi har derfor sett oss nødt til å versjonere dem.

Fra 11.03.2024 tar versjon 2 over som ny standard. Er du ikke klar til å ta i bruk versjon 2, må du eksplisitt be om versjon 1. Hvis du ikke foretar deg noe, risikerer du at api-kallet feiler 11.03.2024.

01.09.2024 fjerner vi versjon 1, innen da må du ha tatt høyde for endringene. Se endringne i Endringslogg.

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.03.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

Generelle endepunkt

Operasjoner mot enhetsregisteret for hovedenheter

Operasjoner mot enhetsregisteret for underenheter

Operasjoner mot roller i enhetsregisteret

Operasjoner mot kommuner i enhetsregisteret

Operasjoner mot organisasjonsformer i enhetsregisteret