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.

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 status-formene, 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 foreldet-ved-oppstrømsfeil.

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 kjenn-din-virksomhet- sjekk: 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 — rolleinnehaver-navn og rollekoder fra det offentlige registeret, aldri fødselsnummer eller andre nasjonale identitetsnumre — så verifiseringslogikken i produktet ditt leser én form.

• Aktiv-status-sjekk. Status og oppløst-tilstand i ett felt, så en onboarding-flyt kan avvise en slettet enhet.
• Signaturrett-sjekk. signaturrett og prokura som strukturerte roller — register- halvdelen av en handleevne-avgjørelse.
• MVA-registrerings-sjekk. mva_registered som en gratis Tier 1 tre-tilstands- verdi (registrert, ikke registrert, eller ukjent).

Kodeeksempel

Start mot null-auth-sandkassen, pek deretter den samme klienten mot produksjonsverten. Tier 1-Brønnøysund-feltene er på gratis-nivå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 selskapskontekst-formen — hvert Tier 1-Brønnøysund-felt og Tier 1 / Tier 2-delingen — ligger i OpenAPI 3.1-spesifikasjonen og utviklerdokumentasjonen.

• OpenAPI 3.1-spesifikasjon (/openapi.json)
• Utviklerdokumentasjon

Hva bygger utviklere på det?

• Kjenn-din-virksomhet-onboarding — verifiser et 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?

Tier 1-Brønnøysund-oppslag er på gratis-nivået — å komme i gang handler mest om en nøkkel for Category B-selskapsendepunktene.

1. Prøv et oppslag i null-auth-sandkassen først — curl sandkasse-speilet mot syntetisk org 999999999, uten nøkkel, og bekreft responsformen.
2. Provisjonér en Apier-API-nøkkel med read:brreg- scope — Category B-selskapsendepunkter krever en nøkkel selv på gratis-nivået.
3. Kall selskapssammendrag- eller kontekst-endepunktet med et gyldig 9-sifret organisasjonsnummer og les de normaliserte Tier 1-feltene.
4. For de gatede Tier 2-målene (ansatt-antall, 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 fix-steg — 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 — Category B-selskapsendepunkter krever en API-nøkkel selv på gratis-nivået; bare null-auth-sandkassen trenger ingen.
• 403 SCOPE_INSUFFICIENT — nøkkelen bærer ikke read:brreg-scopet.
• 503 UPSTREAM_UNAVAILABLE — Brønnøysund er utilgjengelig; Apier serverer mellomlagrede data innenfor 7-dagers taket for foreldet-ved-oppstrømsfeil, eller returnerer dette når ingen cache er tilgjengelig.

Vanlige spørsmål

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 auth-en under de gatede 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.
• Bruk apier sammen med KYB-leverandøren din — utførelseslaget som handler på verifisert selskapsdata.
• Dokumentasjon og Apier-forsiden.

Kom i gang

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