Virksomheter er et API for oppslag/søk i Register over reelle rettighetshavere.
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-UI | OpenAPI-spesifikasjon |
|---|---|---|
| Test | https://rrh.ppe.brreg.no/api/oppslag | https://rrh.ppe.brreg.no/api/oppslag/openapi/openapi.zip |
| Produksjon | https://rrh.brreg.no/api/oppslag | https://rrh.brreg.no/api/oppslag/openapi/openapi.zip |
Se løsningsmodell under informasjonsmodeller for Virksomhet
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ør | Maskinporten-scope | Kodelister | Oppslag på virksomhetens organisasjonsnummer | Oppslag på fødselsnummer eller D-nummer | Nedlasting av totalbestand | Endringslogg |
|---|---|---|---|---|---|---|
| Offentlig myndighet i § 3-11 (1) | brreg:reelle/offentlig | X | X | X | X | X |
| Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav a, b, c, e, g, h til k, n og o | brreg:reelle/rapporteringspliktig | X | X | X | ||
| Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav d, f, l og m | brreg:reelle/rapporteringspliktig.begrenset | X | X | X | ||
| Medier, sivilsamfunnsorganisasjoner og høyere utdanningsinstitusjoner i § 3-11 (2), (3) og (4) ledd. | brreg:reelle/media, brreg:reelle/sivilsamfunnsorganisasjon, brreg:reelle/hoeyereutdanningsinstitusjon | X | X | X | ||
| Alle andre | Krever ikke maskinporten-scope | X |
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ør | Maskinporten-scope | Fødselsnummer og D-nummer |
|---|---|---|
| Offentlig myndighet i § 3-11 (1) | brreg:reelle/offentlig | X |
| Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav a, b, c, e, g, h til k, n og o | brreg:reelle/rapporteringspliktig | X |
| Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav d, f, l og m | brreg:reelle/rapporteringspliktig.begrenset | X |
| 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ør | Maskinporten-scope | Innhold i uoverensstemmelse og uoverensstemmelsesdato | Historiske uoverensstemmelser | Opplysninger om innsender |
|---|---|---|---|---|
| Offentlig myndighet i § 3-11 (1) | brreg:reelle/offentlig | X | X | X |
| Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav a, b, c, e, g, h til k, n og o | brreg:reelle/rapporteringspliktig | X | ||
| Rapporteringspliktige etter hvitvaskingsloven § 4 første ledd bokstav d, f, l og m | brreg:reelle/rapporteringspliktig.begrenset | X | ||
| Medier, sivilsamfunnsorganisasjoner og høyere utdanningsinstitusjoner i § 3-11 (2), (3) og (4) ledd. | brreg:reelle/media, brreg:reelle/sivilsamfunnsorganisasjon, brreg:reelle/hoeyereutdanningsinstitusjon | X |
Noen maskinporten scopes har tilgang til å laste ned totalbestanden over Register over reelle rettighetshavere. Følgende er en veiledning for hvordan totalbestanden kan brukes sammen med endringsloggen for å opprettholde en oppdatert, lokal kopi av registeret. For hvert punkt, referer gjerne til Swagger-UI dokumentasjonen for et overblikk over hvordan responsene til endepunktene ser ut.
For å bygge opp en lokal kopi av Register over reelle rettighetshavere, gjør du følgende:
/virksomheter/totalbestand og lagre den i din lokale database.For å holde din lokale kopi oppdatert med nye endringer, gjør du følgende:
/sekvensnummer med et tidspunkt noen dager før du tok ut totalbestanden. Endepunktet vil returnere et sekvensnummer, som vil være utgangspunktet ditt for å fange opp endringer fra /endringslogg i neste steg./endringslogg./endringslogg med sekvensnummeret du fikk i det forrige steget. Dette vil returnere en logg over alle endringene som har skjedd i registeret, etter sekvensnummeret du fikk. Hver av disse endringene inneholder et organisasjonsnummer som brukes i det neste steget./virksomhet/{organisasjonsnummer}. Dette vil returnere organisasjonens registreringer. Da kan du sammenligne dine lokale registreringer for organisasjonen, med de i Register over reelle rettighetshavere. Oppdater din lokale kopi dersom registreringene dine er forskjellige.id. Da har du det nyeste sekvensnummeret, som kan brukes til å kalle /endringslogg igjen for å lytte på videre endringer.Hvis det er lenge siden du har oppdatert kopien din, kan det lønne seg å heller hente ut totalbestanden på nytt så du slipper å gå igjennom hele endringsloggen.
Totalbestanden oppdateres normalt ved midnatt hver dag, men dette er ikke garantert. For å være trygg på at du får med deg alle endringer, anbefaler vi å bruke /sekvensnummer med et tidspunkt noen dager før uttaket av totalbestanden.
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.
registreringsstatus.rettighetsinformasjonErIkkeMeldt for alle registreringspliktige virksomheter i Register over reelle rettighetsavere.404 - NOT FOUND indikerer det at virksomheten ikke er registreringspliktig og kan dermed ikke registrere seg i registeret.no.brreg.rrh.rettighetsinformasjon.klargjortForRegistrering i responsen til endringsloggen for registreringer med registreringsstatus registreringsstatus.rettighetsinformasjonErIkkeMeldtuoverensstemmelseuoverensstemmelsehentRegistreringspliktigVirksomhet, finnRegistreringspliktigeVirksomheter, hentRelevanteKodelisterAccept-Language. Mulige verdier for headeren: nob (bokmål), nno (nynorsk) og eng (engelsk)Accept-Language-headeren ikke er spesifisert eller er spesifisert med en ugyldig verdi, vil responsen returnere verdier på Bokmål som standard.API-ene er ikke lenger i beta-fasen og kan nå anses som stabile.