Enhetsregisteret

Dette er et åpent API med rolleopplysninger fra Enhets- og Foretaksregisteret. Du må gjøre oppslag på et organisasjonsnummer for å hente alle roller for den aktuelle virksomheten. For rolleinnehaver avgir vi opplysning om navn og fødselsdato. Oversikten viser alle rollene samlet, uavhengig av om de er privatpersoner eller virksomheter.

Denne tjenesten tilbyr både manuelle og maskinelle oppslag, samt nedlastning av datasettet. Tjenesten er delt i to ulike datasett, hovedenheter og underenheter, og presenterer utvalgte dataelement fra Enhets- og Foretaksregisteret.

Tjenesten gir en utvidet tilgang til opplysninger fra Enhets- og Foretaksregisteret som blant annet inneholder roller og signatur/prokura- bestemmelser. Offentlig forvaltning og kredittopplysningsforetak har tilgang til fødselsnummer på roller og signatur/prokura. Alle andre har tilgang til fødselsdato. Denne tjenesten er gratis for virksomheter i offentlig forvaltning, mens private virksomheter må betale for data. Alle må tegne avtale for å få tilgang.

Teknisk beskrivelse av REST-tjenestene i Åpne Data fra Enhetsregisteret - Work in progress

Ordbok

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

Næringskoder på brreg.no

Standard for næringsgruppering

Versjonering

Du kan velge major versjon ved å spesifisere HTTP Accept-headeren. Bruk headeren spesifisert i tabellen under. Hvis versjon ikke spesifiseres, vil man få siste versjon.

  API
  Header




  /
  application/vnd.enhetsregisteret.v1+json


  /organisasjonsformer
  application/vnd.enhetsregisteret.organisasjonsform.v1+json

Strategi

Vi skal normalt ikke bryte bakoverkompabiliteten 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. Se punkt om varsling.

Når innføres ny versjon

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

Når fjernes en versjon

Vi vil legge ut varsel/driftsmeldinger i god tid på følgende steder:

• Driftsmeldinger
• RSS-feed.

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.

Endringslogg

  Versjon
  Dato
  Endring




  1.1.0
  14. august 2018
  Ny tjeneste /oppdateringer/enheter og /oppdateringer/underenheter


  1.0.0
  6. april 2018
  Produksjonssetting av ny åpne data tjeneste for Enhetsregisteret

Api for å benytte tjenester på data.altinn.no. Tilgang krever både autentisert virksomhet (maskinporten) og api-nøkkel som kan fås på data.altinn.no