Virksomheter

Virksomheter er et API for oppslag/søk i Register over reelle rettighetshavere.

  • APIet tilbyr
    • Opplysninger om registrerte virksomheter og deres reelle rettighetshavere
    • Nedlasting av totalbestand på json-format
    • Endringslogg: Dette brukes typisk for å fange opp at det har skjedd endringer på registreringer om reelle rettighetshavere i registeret
    • Kodelister: Kan brukes til visning i eventuelle brukergrensesnitt, dynamisk oppdatering av kodelister, validering og lignende. Endepunktet er åpent, og krever ikke maskinporten-autentisering
    • Se vår Swagger-dokumentasjon for mer mer informasjon om de forskjellige endepunktene, samt eksempler på forespørsler og responser
  • Alle endepunktene i APIet med unntak av Kodelister er tilgangsstyrt, se Tilgang til endepunkter

API-spesifikasjon

APIet er tilgjengelig for konsumering gjennom Swagger-UI og som en nedlastbar OpenAPI-spesifikasjon. Her finner du mer utfyllende informasjon om hva APIet tilbyr.

MiljøSwagger-UIOpenAPI-spesifikasjon
Testhttps://rrh.ppe.brreg.no/api/oppslaghttps://rrh.ppe.brreg.no/api/oppslag/openapi/openapi.zip
Produksjonhttps://rrh.brreg.no/api/oppslaghttps://rrh.brreg.no/api/oppslag/openapi/openapi.zip

Løsningsmodell

Se løsningsmodell under informasjonsmodeller for Virksomhet

Tilgang til endepunkter

Vi tilbyr ulike maskinporten-scopes til forskjellige aktører. Tabellen under beskriver hvilke endepunkter maskinporten-scopene har tilgang til. Alle endepunktene i APIet med unntak av Kodelister er tilgangsstyrt, se tabellen under for å finne ut hva ditt maskinporten-scope har tilgang til.

AktørMaskinporten-scopeKodelisterOppslag på virksomhetens organisasjonsnummerOppslag på fødselsnummer eller D-nummerNedlasting av totalbestandEndringslogg
Offentlig myndighet i § 3-11 (1)brreg:reelle/offentligXXXXX
Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav a, b, c, e, g, h til k, n og obrreg:reelle/rapporteringspliktigXXX
Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav d, f, l og mbrreg:reelle/rapporteringspliktig.begrensetXXX
Medier, sivilsamfunnsorganisasjoner og høyere utdanningsinstitusjoner i § 3-11 (2), (3) og (4) ledd.brreg:reelle/media, brreg:reelle/sivilsamfunnsorganisasjon, brreg:reelle/hoeyereutdanningsinstitusjonXXX
Alle andreKrever ikke maskinporten-scopeX

Tilgang til informasjon som er begrenset

Se tabellen under for å finne ut om ditt maskinporten-scope har tilgang til å se fødselsnummer og D-Nummer. Full oversikt over alle tilgjengelige felter og særregler kan ses i løsningsmodell for virksomhet.

AktørMaskinporten-scopeFødselsnummer og D-nummer
Offentlig myndighet i § 3-11 (1)brreg:reelle/offentligX
Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav a, b, c, e, g, h til k, n og obrreg:reelle/rapporteringspliktigX
Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav d, f, l og mbrreg:reelle/rapporteringspliktig.begrensetX
Medier, sivilsamfunnsorganisasjoner og høyere utdanningsinstitusjoner i § 3-11 (2), (3) og (4) ledd.brreg:reelle/media, brreg:reelle/sivilsamfunnsorganisasjon, brreg:reelle/hoeyereutdanningsinstitusjon

Se tabellen under for hvilke data ditt maskinporten-scope har tilgang til å se om uoverensstemmelser.

AktørMaskinporten-scopeInnhold i uoverensstemmelse og uoverensstemmelseDatoHistorikkOpplysning om varslingspliktigVirksomhet
Offentlig myndighet i § 3-11 (1)brreg:reelle/offentligXXX
Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav a, b, c, e, g, h til k, n og obrreg:reelle/rapporteringspliktigX
Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav d, f, l og mbrreg:reelle/rapporteringspliktig.begrensetX
Medier, sivilsamfunnsorganisasjoner og høyere utdanningsinstitusjoner i § 3-11 (2), (3) og (4) ledd.brreg:reelle/media, brreg:reelle/sivilsamfunnsorganisasjon, brreg:reelle/hoeyereutdanningsinstitusjonX

Endringer i APIet

Her dokumenteres alle endringer som er gjort på Virksomhet APIet for Reelle Rettighetshavere.
Formatet er basert på keep a changelog og dette prosjektet følger semantisk versjonering.

1.4.0 - 2025-03-28

Lagt til

  • Gitt tilgang til endepunkt for å hente endringslogg til følgende Maskinporten-scope:
    • brreg:reelle/offentlig (Hadde tilgang fra før)
    • brreg:reelle/rapporteringspliktig
    • brreg:reelle/rapporteringspliktig.begrenset
    • brreg:reelle/media
    • brreg:reelle/sivilsamfunnsorganisasjon
    • brreg:reelle/hoeyereutdanningsinstitusjon

1.3.0 - 2025-03-21

Lagt til

  • Vi tilgjengeliggjør nå en registrering med registreringsstatus registreringsstatus.rettighetsinformasjonErIkkeMeldt for alle registreringspliktige virksomheter i Register over reelle rettighetsavere.
    • Denne typen registrering er opprettet av Brønnøysundregistrene, og indikerer at virksomheten er registeringspliktig i registeret.
    • Merk: Hvis oppslag på opplysninger om reelle rettighetshavere returnerer 404 - NOT FOUND indikerer det at virksomheten ikke er registreringspliktig og kan dermed ikke registrere seg i registeret.
  • Ny type no.brreg.rrh.rettighetsinformasjon.klargjortForRegistrering i responsen til endringsloggen for registreringer med registreringsstatus registreringsstatus.rettighetsinformasjonErIkkeMeldt

1.2.1 - 2025-03-21

Lagt til

  • Tabell over tilgang til data om uoverensstemmelse

1.2.0 - 2025-03-06

Lagt til

  • Registreringer kan nå inneholde opplysninger om uoverensstemmelse
    • Se løsningsmodellen for mer informasjon.

1.1.0 - 2024-10-24

Lagt til

  • Språkstøtte for kodelisteverdier
    • Det er introdusert et nytt parameter som muliggjør uthenting av responser med kodelisteverdier også på nynorsk og engelsk.
    • Funksjonaliteten er implementert på følgende endepunkter: hentRegistreringspliktigVirksomhet, finnRegistreringspliktigeVirksomheter, hentRelevanteKodelister
    • Funksjonaliteten er implementert i form av en frivillig HTTP-header: Accept-Language. Mulige verdier for headeren: nob (bokmål), nno (nynorsk) og eng (engelsk)
    • Hvis Accept-Language-headeren ikke er spesifisert eller er spesifisert med en ugyldig verdi, vil responsen returnere verdier på Bokmål som standard.

1.0.0 - 2024-09-28

API-ene er ikke lenger i beta-fasen og kan nå anses som stabile.

1.0.0-beta2 - 2024-02-28

Lagt til

  • Nytt endepunkt for å hente en liste med alle tilgjenglige kodelister. Dette endepunktet kan feks. brukes til visning i eventuelle brukergrensesnitt, dynamisk oppdatering av kodelister, validering og lignende.

Endret

  • Funksjonalitet for oppslag på virksomhet er endret til å inkludere opplysninger om både nåværende og tidligere registrerte reelle rettighetshavere.
  • Søk på fødselsnummer er oppdatert til å gi en liste over virksomheter hvor personen, identifisert ved det angitte fødsels- eller D-nummeret, er eller har vært registrert som reell rettighetshaver.