Orakel-dokumentasjon
Datakilder

Brønnøysundregistrene

Norges sentrale foretaksregister: firmadata, underenheter og roller fra Enhetsregisteret.

Kildehenvisning

Kilde: Brønnøysundregistrene (Brreg)
Data: Bedrifter (Enhetsregisteret), underenheter, roller (styre, daglig leder, revisor)
Lisens: NLOD 2.0 (Norsk lisens for offentlige data)
Kreditering påkrevd: ja, «Brønnøysundregistrene» må krediteres ved videreformidling
Lenke: https://www.brreg.no
Oppdatering: hvert 15. minutt (endringer), fullt uttrekk månedlig

Hva det er

Brønnøysundregistrene er Norges sentrale register for foretak og organisasjoner. Hver juridisk enhet registrert i Norge (AS, ASA, ENK, NUF, stiftelser, kommuner og foreninger) har et kort her, med et niesifret organisasjonsnummer som nøkkel.

Orakel laster inn hele datasettet og følger endringer gjennom endringsstrømmen til Brønnøysundregistrene. Hvert 15. minutt hentes nye endringer og de berørte kortene oppdateres. Én gang i måneden lastes et fullt uttrekk inn på nytt, for å fange opp det strømmen måtte ha gått glipp av.

Felt som følger med

FeltTypeMerknad
orgNumbertekst (9 siffer)Del av den sammensatte nøkkelen (country, orgNumber). For norske rader er country = "NO".
nametekstRegistrert navn
orgFormCode / orgFormDescriptiontekstAS, ASA, ENK, NUF og så videre
naceCode1 / naceDescription1tekstHovednæring (NACE)
naceCode2 / naceCode3tekstInntil to næringskoder til
employeeCountheltallRegistrert antall ansatte
hasRegisteredEmployeesboolskNoen bedrifter leverer uten antall
businessAddress*tekstGate, postnummer, poststed, kommunenavn og kommunenummer
postalAddress*tekstEgen postadresse der den avviker
websitetekstSlik den er registrert hos Brønnøysundregistrene. Ikke alltid oppdatert
phonetekstSlik det er registrert
parentOrgNumbertekstNærmeste morselskap i et konsern
foundingDatedatoStiftelsesdato
registrationDatedatoRegistreringsdato i Enhetsregisteret
registeredInVatboolskRegistrert i Merverdiavgiftsregisteret
registeredInBizboolskRegistrert i Foretaksregisteret
isBankruptboolskKonkurs
isBeingDissolvedboolskUnder avvikling eller tvangsavvikling
isInGroupboolskDel av et konsern
sectorCode / sectorDescriptiontekstInstitusjonell sektorkode
subUnits[]posterUnderenheter, altså avdelinger, hver med eget orgNumber, beliggenhetsadresse, antall ansatte og næringskode
roles[]posterStyremedlemmer, daglig leder, revisor og lignende. Se Roller under

Roller

Hver rolle bærer:

FeltTypeMerknad
roleGroupCode / roleGroupDescriptiontekstFor eksempel STYR (styret)
roleTypeCode / roleTypeDescriptiontekstFor eksempel LEDE (styreleder), DAGL (daglig leder), REVI (revisor)
personFirstName / personMiddleName / personLastNametekstNår rollehaveren er en person
personBirthDatedatoFull fødselsdato slik den er innlevert
entityOrgNumber / entityNametekstNår rollehaveren er et foretak, for eksempel et revisjonsselskap
isResignedboolskFratrådt
isDeregisteredboolsk
sortOrderheltallRekkefølge, stabil innenfor en rollegruppe

Endepunkter som gir deg dette

  • GET /api/companies: søk i bedrifter. Returnerer firmadata fra Brønnøysundregistrene sammen med regnskapstall og aktive roller
  • GET /api/companies/:orgNumber: hele bedriftskortet. Norske bedrifter som ennå ikke ligger i databasen, hentes direkte fra Brønnøysundregistrene og mellomlagres
  • GET /api/companies/:orgNumber/group: konserntreet, bygget fra parentOrgNumber
  • GET /api/updates?since=<ISO-dato>: en strøm med markørsidevisning over bedrifter som er endret etter tidspunktet du oppgir. Bygger på registerets egen endringsstrøm

Begrensninger

  • Brønnøysundregistrene dekker firmadata og roller. Regnskapstall ligger i Regnskapsregisteret, og aksjonærdata i Aksjonærregisteret.
  • Feltet website er selvrapportert ved registrering og er ofte utdatert. Orakel kjører en egen berikelsespipeline (primaryDomain, enrichedDomains) som gir et verifisert domene.
  • Antall ansatte på morselskapet inkluderer ikke de ansatte i underenhetene. Vil du ha en sum, må du legge sammen subUnits[].

Verdt å vite

  • Endringsstrømmen hvert 15. minutt kan ligge noen minutter bak det du ser i Brønnøysundregistrenes egne sider. Trenger du et garantert ferskt kort, send ?country=NO til GET /api/companies/:orgNumber. Finnes ikke kortet i databasen, hentes det direkte fra registeret.
  • Oppløste og konkursrammede bedrifter beholdes. dissolvedAt kan være satt mens kortet fortsatt dukker opp i søk. Filtrer på isBankrupt eller isBeingDissolved hvis du vil utelate dem.
  • orgNumber er unikt i Norge, men på tvers av de nordiske registrene lagrer Orakel kort under (country, orgNumber). Send alltid country eksplisitt når du henter et bestemt kort fra en klient som dekker flere land.
  • Revisorer lagres som foretaksroller (entityOrgNumber er fylt ut), ikke som personroller. Styreroller er knyttet til personer.