Utvikler-API

Brønnøysund (BRREG) API

Norsk selskapsoppslag: Enhetsregisteret, Foretaksregisteret og virksomhetsverifisering gjennom én normalisert flate.

Hva er Brønnøysund (BRREG)-API-et?

Brønnøysundregistrene driver Norges grunnleggende næringslivsregistre. De er den autoritative kilden for en virksomhets organisasjonsnummer, navn, organisasjonsform, NACE-næringskode, registrert adresse, status og signaturrett.

Vil du se hvordan oppslaget gjøres i praksis? Hvordan får jeg tilgang til data fra Brønnøysundregistrene gjennom et REST-API? går gjennom registrene, feltene du får tilbake og hvordan ferskhet og mellomlagring henger sammen.

Hvorfor er rå registerdata ikke et selskapsoppslag?

Registrene returnerer data, ikke svar. Et direkte oppsett må hente fra mer enn ett register, normalisere rolle- og statusformene, mellomlagre ansvarlig så du ikke hamrer på en offentlig tjeneste, og holde seg innenfor vilkårene for gjenbruk av åpne data. Apier gjør det én gang og eksponerer én normalisert selskapskontekst, NLOD-lisensiert, med et 24-timers ferskhetsvindu og et 7-dagers tak for data merket som foreldet når oppstrømmen feiler.

Hva er Enhetsregisteret?

Enhetsregisteret er det bredeste registeret. Hver registrerte norske enhet har en oppføring. Det bærer organisasjonsnummer, navn, organisasjonsform (AS, ENK, NUF og resten), NACE-næringskode, registrert kommune og gjeldende status, inkludert om enheten er oppløst. Om enheten er registrert i Merverdiavgiftsregisteret (registrertIMvaregisteret) er en del av denne oppføringen også.

Hva er Foretaksregisteret?

Foretaksregisteret dekker enheter som driver næringsvirksomhet og bærer den rettslig bindende rolledetaljen: signaturrett, prokura, daglig leder og styremedlemmer. Det er her du bekrefter ikke bare at et selskap finnes, men hvem som er autorisert til å binde det. Et AS finnes i begge registrene; en enhet uten næringsvirksomhet kan finnes bare i Enhetsregisteret.

Hvordan verifiserer jeg en virksomhet?

Kombiner de to registrene og du har en kundekontroll av virksomheten: bekreft at organisasjonsnummeret er gyldig, at enheten er aktiv og ikke oppløst, at NACE-koden matcher det oppgitte virkeområdet, og at personen som registrerer seg er navngitt i signaturrett eller prokura. Apier returnerer disse som strukturerte felter (rolleinnehavernavn og rollekoder fra det offentlige registeret, aldri fødselsnummer eller andre nasjonale identitetsnumre), så verifiseringslogikken i produktet ditt leser én form.

Sjekk av aktiv status. Status og oppløst tilstand i ett felt, så en oppstartsflyt kan avvise en slettet enhet.
Signaturrettsjekk. signaturrett og prokura som strukturerte roller: registerhalvdelen av en handleevneavgjørelse.
MVA-registreringssjekk. mva_registered som en gratis Tier 1 tretilstandsverdi (registrert, ikke registrert, eller ukjent).

Kodeeksempel

Start mot sandkassen uten autentisering, pek deretter den samme klienten mot produksjonsverten. Tier 1-Brønnøysund-feltene er på gratisnivået.

# Zero-auth sandbox — synthetic fixture org 999999999.
# Tier 1 Brønnøysund fields: name, entity_type, nace_codes, status,
# municipality, signaturrett, prokura, mva_registered.
curl https://www.apier.no/api/v1/sandbox/public/company/999999999/summary

# Production — Tier 1 Brønnøysund data on the free tier.
curl -H "Authorization: Bearer apier_live_<your_key>" \
  "https://www.apier.no/api/v1/company/991825827/context"

Hvor finner jeg API-referansen?

Den fullstendige selskapskontekstformen (hvert Tier 1-Brønnøysund-felt og Tier 1 / Tier 2-delingen) ligger i OpenAPI 3.1-spesifikasjonen og utviklerdokumentasjonen.

Hva bygger utviklere på det?

Ny bedriftskunde: Verifiser organisasjonsnummer, status og signaturrett før du åpner en konto.
Berik et CRM eller regnskap med normalisert selskapsdata: navn, organisasjonsform, NACE, kommune, MVA-registreringsstatus.
Gi en AI-agent registerkonteksten den trenger før den resonnerer om et selskaps plikter eller forsøker en handling.

Hvordan kommer jeg i gang?

Oppslag i Brønnøysund på Tier 1 er gratis, så for å komme i gang trenger du i praksis bare en nøkkel for Kategori B-selskapsendepunktene.

Prøv et oppslag i sandkassen uten autentisering først. Kjør curl mot sandkassespeilet for syntetisk org 999999999, uten nøkkel, og bekreft responsformen.
Opprett en Apier-API-nøkkel med scopet read:brreg. Kategori B-selskapsendepunkter krever en nøkkel selv på gratisnivået.
Kall selskapssammendrag- eller kontekstendepunktet med et gyldig 9-sifret organisasjonsnummer og les de normaliserte Tier 1-feltene.
For de låste Tier 2-målene (antall ansatte, omsetning, balansesum), få virksomheten til å gi kontoen din en Altinn-delegering.

Hvordan håndterer jeg feil?

Hver feil følger Apiers strukturerte Compliance Explainer-format: en error_code, en lesbar explanation (med valgfri explanation.details) og konkrete rettesteg, uten at rå Brønnøysund-interne detaljer lekker. Hver respons bærer en X-Correlation-ID du kan oppgi til support.

400 VALIDATION_FAILED: Organisasjonsnummeret er ikke et gyldig 9-sifret norsk org_number; rett det og send på nytt.
404 NOT_FOUND: Enhetsregisteret har ingen treff for organisasjonsnummeret; enheten er avregistrert, ennå ikke registrert, eller nummeret er feil.
401 AUTH_MISSING: Kategori B-selskapsendepunkter krever en API-nøkkel selv på gratisnivået; bare sandkassen uten autentisering trenger ingen.
403 SCOPE_INSUFFICIENT: Nøkkelen bærer ikke scopet read:brreg.
503 UPSTREAM_UNAVAILABLE: Brønnøysund er utilgjengelig; Apier serverer mellomlagrede data, merket som foreldet, innenfor 7-dagers taket som gjelder når oppstrømmen feiler, eller returnerer dette når ingen cache er tilgjengelig.

Vanlige spørsmål

Hva er Brønnøysund (BRREG)?

Brønnøysundregistrene driver Norges grunnleggende næringslivsregistre, blant annet Enhetsregisteret og Foretaksregisteret. De er den autoritative kilden for en norsk virksomhets organisasjonsnummer, navn, organisasjonsform, NACE-næringskode, registrert adresse, status og signaturrett.

Hva er forskjellen på Enhetsregisteret og Foretaksregisteret?

Enhetsregisteret er det sentrale samordningsregisteret. Hver registrerte enhet har en oppføring med organisasjonsnummer, navn, organisasjonsform, NACE-kode, registrert adresse og status. Foretaksregisteret er registeret over foretak som driver næringsvirksomhet; det bærer den rettslig bindende rolle- og signaturrettdetaljen (signaturrett, prokura, daglig leder, styremedlemmer). Et AS finnes i begge; en hobbyforening kan finnes bare i Enhetsregisteret.

Er Brønnøysund-selskapsdata gratis å bruke?

Tier 1-registerdataene Apier henter fra Brønnøysund er offentlig informasjon gjenbrukt under NLOD-lisensen for åpne data, tilgjengelig på gratisnivået og gjennom sandkassen uten autentisering. Bare de låste Tier 2-kommersielle målene (antall ansatte, omsetning, balansesum) krever en Altinn-delegering. Rolleinnehavere returneres med navn i offentlige registre og rollekoder akkurat slik de står i Enhetsregisteret og Foretaksregisteret; Apier returnerer aldri fødselsnummer eller andre nasjonale identitetsnumre.

Kan jeg verifisere hvem som har lov til å signere for et selskap?

Ja. Selskapskonteksten viser signaturrett og prokura som strukturert rolledata, pluss virksomhetens status så du kan bekrefte at den er aktiv og ikke oppløst. Dette er registerhalvdelen av en handleevnesjekk; å avgjøre om en bestemt aktør kan ta en bestemt handling trekker også på Altinn-delegeringsmodellen.

Inkluderer oppslaget MVA-registreringsstatus?

Ja. Om et selskap er registrert i Merverdiavgiftsregisteret (registrertIMvaregisteret) er et gratis Tier 1-faktum hentet fra Enhetsregisteret i Brønnøysund, og det krever ingen delegering. Det eksponeres som mva_registered på selskapssammendrag- og kontekstresponsene, som en tretilstandsverdi (registrert, ikke registrert, eller ukjent når registeret ennå ikke er lest).

Relaterte utviklersider

Altinn for AI-agenter: agenter som konsumerer selskapsdata før de handler på den.
Altinn API: delegeringslaget som registerroller løses opp mot.
Maskinporten API: den brokerte autentiseringen under de låste flatene.
Filing History API: hva et selskap har sendt inn, sammen med hvem som kan signere for det.
Webhooks API: Bli varslet når et selskaps registerdata endres i stedet for å polle på nytt.
KYB API for norske selskaper: omfang og avgrensninger. Laget for selskapsfakta og signaturrett i KYB, og hva Apier ikke leverer.
Hvordan gjør jeg mitt første BRREG-API-kall steg for steg?
Hva er Brønnøysundregistrene? Registeret bak dataene, forklart fra bunnen.
Dokumentasjon og Apier-forsiden.

Kom i gang

Sandkassen returnerer syntetiske Brønnøysund-formede data uten registrering; dokumentasjonen dekker den fulle selskapskontekstformen og Tier 1 / Tier 2-delingen.

Les dokumentasjonen Prøv sandkassen