|
Vi har nå innført en versjon 2 for en del endepunkter. Versjon 2 tar over for versjon 1 som ny standard 01.03.2024. Versjon 1 fjernes 01.09.2024. Se detaljer her: Hvorfor har vi versjon 2? |
Introduksjon
Velkommen til API-dokumentasjonen for Åpne data - Enhetsregisteret. Her finner du en teknisk beskrivelse av alle REST-tjenestene i APIet, samt eksempler på både HTTP forespørsler og svar (Merk at enhetene som avgis i dokumentasjonen ikke er reelle).
Endringslogg
| Dato | Endepunkt | Endring |
|---|---|---|
13.09.2023 |
/enheter |
Også nytt i versjon 2:
|
13.09.2023 |
/enheter |
Innført versjon 2:
|
13.09.2023 |
Endre celler til å inneholde fullstendige verdier:
|
|
27.07.2023 |
Innfør totalbestand på CSV format |
Tjenestene i APIet
Oversikt
| HTTP-METODE | ENDEPUNKT | BESKRIVELSE |
|---|---|---|
GET |
/ |
Rot. Lister lenker til øvrige tjenester |
GET |
Søk etter enheter |
|
GET |
Hent en spesifikk enhet |
|
GET |
Hent alle roller for en spesifikk enhet |
|
GET, HEAD |
Last ned enheter i json-format |
|
GET, HEAD |
Last ned enheter i csv-format |
|
GET, HEAD |
Last ned enheter i xlsx-format |
|
GET |
Søk etter underenheter |
|
GET, HEAD |
Hent en spesifikk underenhet |
|
GET, HEAD |
Last ned underenheter i json-format |
|
GET, HEAD |
Last ned underenheter i csv-format |
|
GET, HEAD |
Last ned underenheter i xlsx-format |
|
GET |
Hent oppdaterte enheter |
|
GET |
Hent oppdaterte underenheter |
|
GET |
Hent rolleoppdateringer |
|
GET |
Hent alle organisasjonsformer |
|
GET |
Hent organisasjonsformer for enheter |
|
GET |
Hent organisasjonsformer for underenheter |
|
GET |
Hent en gitt organisasjonsform |
|
GET |
Last ned totalbestand av roller for alle enheter |
|
GET |
Hent rolletyper |
|
GET |
Hent rollegruppetyper |
|
GET |
Hent representanter |
|
GET |
Hent en gitt matrikkelenhet |
Ordbok
Organisasjonsnummer
Nisifret nummer som entydig identifiserer enheter i Enhetsregisteret.
Enhet
Enhet på øverste nivå i registreringsstrukturen i Enhetsregisteret. Eksempelvis enkeltpersonforetak, foreninger, selskap, sameier og andre som er registrert i Enhetsregisteret. Identifiseres med organisasjonsnummer.
Underenhet
Enhet på laveste nivå i registreringsstrukturen i Enhetsregisteret. En underenhet kan ikke eksistere alene og har alltid knytning til en hovedenhet. Identifiseres med organisasjonsnummer.
Organisasjonsform
Organisasjonsform er virksomhetens formelle organisering og gir retningslinjer overfor blant annet ansvarsforhold, skatt, revisjonsplikt, rettigheter og plikter.
Næringskode
Noen virksomheter har både ordinær næringskode og en hjelpeenhetskode. I disse tilfellene bør de ordinære næringskodene presenteres først med kode og tekst. Deretter vises hjelpeenhetskoden som tekst, uten kode - med tillegg av teksten "Yter tjenester til eget konsern".
Næringskode: |
11.050 Produksjon av øl Engroshandel med drikkevarer ellers: |
Se Næringskoder på brreg.no
Standard for næringsgruppering finner du på ssb.no
Kommune og geografisk områdeinndeling
Enhetens forretningsadresse, postadresse eller beliggenhetsadresse er knyttet til en kommune eller en geografisk områdeinndeling. Fra 01.01.2019 vil områdene Spitsbergen, Bjørnøya og Hopen inngå i den geografiske områdeinndelingen Svalbardområde, med kode 2100.
Oversikt over kommuner og geografiske områdeinndelinger finner du på Standard for kommuneinndeling og Standard for regionale spesialkoder fra SSB.
Matrikkelenhet
Et objekt som er registrert som en enhet i matrikkelen. Slike matrikkelenheter er først og fremst grunneiendommer, betegnet ved gårds- og bruksnummer, eierseksjoner eller festegrunn.
Hjelpeenhet
Hjelpeenheter er enheter som bare yter konsern- eller foretaksinterne tjenester og som skal næringskodes lik enheten(e) de yter tjenester til. De tildeles en alternativ næringskode - hjelpeenhetskode - som viser hvilken type tjeneste som utføres.
Rolle
Med roller menes relasjoner en enhet kan ha til fysiske personer eller andre enheter i Enhetsregisteret.
Rolletype
Kodeliste/enum. Rolletype beskriver rolle-objektet ytterligere. Feltene i objektet kan variere for forskjellige rolletyper, for eksempel:
-
INNH(innehaver) registreres som person med fødselsdato på et enkeltpersonforetak. -
REVI(revisor) registreres som enhet med organisasjonsnummer.
Rollegruppe
En rollegruppe er en logisk samling av roller, som kan grupperes sammen.
Rollegruppetype
Kodeliste/enum. En rollegruppetype forteller hvilke roller som ligger under en rollegruppe. For eksempel:
-
STYREer en rollegruppe for disse rollene: Styrets leder, nestleder, styremedlem, varamedlem og observatør.
Representant
Kodeliste/enum. Representant viser hvem vedkommende representerer i styret. Det kan være enten de ansatte, A-, B- eller C-aksjonærer.
Media Typer
De fleste tjenestene svarer med JSON, på HAL formatet (Hypertext Application Language). Unntaket er nedlastingstjenestene, som resulterer i GZIP-komprimert JSON uten HAL.
| Media typer (enhet) | Kommentar |
|---|---|
application/json;utf+8 |
Ikke versjonert. Svar fra siste versjon på HAL format |
application/hal+json;utf+8 |
Ikke versjonert. Svar fra siste versjon på HAL format |
application/vnd.brreg.enhetsregisteret.enhet.v1+json;charset=UTF-8 |
Eksplisitt versjon 1. Svar fra versjon 1 på HAL format |
Se mer om versjonering i seksjonen om Versjonering.
Feilhåndtering
400 Ugyldig forespørsel
Alle endepunktene har felles validering for parametere. Dersom en eller flere parametere har ugyldig verdi, får du en respons med statuskode 400. Alle ugyldige parametere vil listes ut, med forklaring på hvorfor.
Under ser du eksempel på 400 respons, med ugyldig verdi for organisasjonsnummer.
HTTP/1.1 400 Bad Request
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 367
{
"tidsstempel" : 1622200011303,
"status" : 400,
"feilmelding" : "Feilaktig forespørsel",
"sti" : "/enhetsregisteret/api/enheter/9ECD01011/roller",
"antallFeil" : 1,
"valideringsfeil" : [ {
"feilmelding" : "Organisasjonsnummer må være et nummer med nøyaktig 9 siffer",
"parametere" : [ "9ECD01011" ],
"feilaktigVerdi" : "9ECD01011"
} ]
}404 Ikke funnet
Dersom du sender en forespørsel på et endepunkt der ressurs ikke finnes, selv om forespørselen er gyldig, får du en respons med status 404 og uten innhold.
500 Feil på server
Alle endepunktene har felles feilhandtering for uventede feil. Hvis det skulle oppstå en feil, så vil du få en respons med statuskode 500.
Hvis du ønsker å rapportere feilen til oss, så er det fint om du også sender oss trace fra responsen. Dette er en UUID som gjør at vi lettere kan finne frem loggene fra forespørselen som feilet.
Under ser du et eksempel på en 500 respons:
HTTP/1.1 500 Internal Server Error
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 257
{
"timestamp" : "2021-05-28T11:34:33.435+0000",
"status" : 500,
"error" : "Internal Server Error",
"message" : "Internal Server Error",
"path" : "/enhetsregisteret/api/enheter/999999999/roller",
"trace" : "5631709a-6e3e-4b72-94e7-fcbf6341272a"
}Enheter
Søk etter enheter
Tjenesten tilbyr et søk på enheter i Enhetsregisteret. Søket kan spesifiseres med søkeparametere angitt som HTTP query-parametere, se beskrivelse. Søkeresultatet er paginert med en standard sidestørrelse på 20 enheter.
|
Resultatsettet er begrenset til 10 000 enheter per spørring. Se enheter/lastned for nedlasting av komplett datasett. |
Eksempel 1 - Hent alle enheter (V1 - erstattes av V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter' -i -X GETGET /enhetsregisteret/api/enheter HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 3194
{
"_embedded" : {
"enheter" : [ {
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}, {
"organisasjonsnummer" : "443322119",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonforetak",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"antallAnsatte" : 0,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : false,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Nynorsk",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 2 - Hent alle enheter (V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter' -i -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8'GET /enhetsregisteret/api/enheter HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8
Content-Length: 3510
{
"_embedded" : {
"enheter" : [ {
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"harRegistrertAntallAnsatte" : true,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"konkursdato" : "",
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"vedtektsdato" : "2017-10-21",
"vedtektsfestetFormaal" : [ "" ],
"aktivitet" : [ ],
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}, {
"organisasjonsnummer" : "443322119",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonforetak",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"harRegistrertAntallAnsatte" : false,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : false,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"konkursdato" : "",
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Nynorsk",
"vedtektsdato" : "2017-10-21",
"vedtektsfestetFormaal" : [ "" ],
"aktivitet" : [ ],
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 3 - Søk etter enheter
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2017-10-20&tilRegistreringsdatoEnhetsregisteret=2017-10-20&konkurs=false' -i -X GETGET /enhetsregisteret/api/enheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2017-10-20&tilRegistreringsdatoEnhetsregisteret=2017-10-20&konkurs=false HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 2624
{
"_embedded" : {
"enheter" : [ {
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
} ]
},
"_links" : {
"first" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2017-10-20&tilRegistreringsdatoEnhetsregisteret=2017-10-20&konkurs=false&page=0&size=1"
},
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2017-10-20&tilRegistreringsdatoEnhetsregisteret=2017-10-20&konkurs=false"
},
"next" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2017-10-20&tilRegistreringsdatoEnhetsregisteret=2017-10-20&konkurs=false&page=1&size=1"
},
"last" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2017-10-20&tilRegistreringsdatoEnhetsregisteret=2017-10-20&konkurs=false&page=1&size=1"
}
},
"page" : {
"size" : 1,
"totalElements" : 2,
"totalPages" : 2,
"number" : 0
}
}Eksempel 4 - Sortere søkeresultatet
Resultatsettet kan sorteres ved å angi sort query-parameteret.
Format: sort={feltnavn},{ASC/DESC}
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter?sort=antallAnsatte,ASC' -i -X GETGET /enhetsregisteret/api/enheter?sort=antallAnsatte,ASC HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 3217
{
"_embedded" : {
"enheter" : [ {
"organisasjonsnummer" : "443322119",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonforetak",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"antallAnsatte" : 0,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : false,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Nynorsk",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
}, {
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter?sort=antallAnsatte,ASC"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 5 - Feilaktig spørring
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter?fraAntallAnsatte=-1&tilAntallAnsatte=-2' -i -X GETGET /enhetsregisteret/api/enheter?fraAntallAnsatte=-1&tilAntallAnsatte=-2 HTTP/1.1
Host: data.brreg.noHTTP/1.1 400 Bad Request
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 583
{
"tidsstempel" : 1695368914245,
"status" : 400,
"feilmelding" : "Feilaktig forespørsel",
"sti" : "/enhetsregisteret/api/enheter",
"antallFeil" : 3,
"valideringsfeil" : [ {
"feilmelding" : "Fra må være mindre eller lik til",
"parametere" : [ "fraAntallAnsatte", "tilAntallAnsatte" ]
}, {
"feilmelding" : "fra må være større eller lik 0",
"parametere" : [ "fraAntallAnsatte" ],
"feilaktigVerdi" : "-1"
}, {
"feilmelding" : "til må være større eller lik 0",
"parametere" : [ "tilAntallAnsatte" ],
"feilaktigVerdi" : "-2"
} ]
}| Path | Type | Description |
|---|---|---|
|
|
Tidspunkt feilen oppstod |
|
|
HTTP status kode |
|
|
Feilmelding |
|
|
Endepunktets sti |
|
|
Antall valideringsfeil |
|
|
Valideringsfeilene |
|
|
Feilmelding for aktuell valideringsfeil |
|
|
Aktuelle parametere |
|
|
Aktuell verdi |
* Obligatorisk, feltet vil alltid være med i responsen.
Detaljer
Om navnesøket
Navnesøket er et fritekstsøk som rangerer enheter basert på søketeksten.
Om tjenesten
Responsfelt er felles for alle "200 - OK"-responser i denne tjenesten.
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Enhetens navn |
String |
Fritekst |
|
Organisasjonsnummeret til enheten |
String |
Kommaseparert liste med organisasjonsnummer |
|
Organisasjonsnummeret til enhetens overordnede enhet |
String |
Streng med 9 siffer |
|
Minste antall ansatte hos enheten |
Int |
Tall større enn eller lik 0 |
|
Største antall ansatte hos enheten |
Int |
Tall større enn eller lik 0 |
|
Hvorvidt enheten er registrert som konkurs |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Mva-registeret |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Foretaksregisteret |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
Boolean |
true/false |
|
Frivillig registrert i Merverdiavgiftsregisteret |
String |
Kommaseparert liste med beskrivelser |
|
Hvorvidt enheten er registrert som underTvangsavvikling eller tvangsopplosning |
Boolean |
true/false |
|
Hvorvidt enheten er registrert som underAvvikling |
Boolean |
true/false |
|
Tidligste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste stiftelsesdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste stiftelsesdato hos enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Enhetens organisasjonsform |
String |
Kommaseparert liste med organisajonsformer |
|
Enhetens hjemmeside |
String |
Fritekst |
|
Enhetens institusjonelle sektorkode |
String |
Kommaseparert liste med sektorkoder på 4 siffer |
|
Kommunenummer til enhetens postadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummeret til enhetens postadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til enhetens postadresse |
String |
Fritekst |
|
Landkode til enhetens postadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens postadresse |
String |
Kommaseparert liste med adresser |
|
Kommunenummeret til enhetens forretningsadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummer til enhetens forretningsadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til enhetens forretningsadresse |
String |
Fritekst |
|
Landkode til enhetens forretningsadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens forretningsadresse |
String |
Kommaseparert liste med adresser |
|
Enhetens næringskode |
Array |
Kommaseparert liste med næringskoder |
|
Årstall for siste innsendte årsregnskap for enheten |
String |
Kommaseparert liste med årstall på 4 siffer |
|
Sortering av resultatsett |
String |
Feltnavn i enheten. Se Eksempel 3 - Sortere søkeresultat |
|
Sidestørrelse |
Int |
Tall større enn 0 |
|
Sidenummer |
Int |
Tall større enn eller lik 0 |
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Enhetens navn |
String |
Fritekst |
|
Organisasjonsnummeret til enheten |
String |
Kommaseparert liste med organisasjonsnummer |
|
Organisasjonsnummeret til enhetens overordnede enhet |
String |
Streng med 9 siffer |
|
Minste antall ansatte hos enheten |
Int |
Tall må være 0, 1 eller større enn 4 |
|
Største antall ansatte hos enheten |
Int |
Tall må være 0, 4, eller over 4 |
|
Hvorvidt enheten er registrert som konkurs |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Mva-registeret |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Foretaksregisteret |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
Boolean |
true/false |
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
Boolean |
true/false |
|
Frivillig registrert i Merverdiavgiftsregisteret |
String |
Kommaseparert liste med beskrivelser |
|
Hvorvidt enheten er registrert som underTvangsavvikling eller tvangsopplosning |
Boolean |
true/false |
|
Hvorvidt enheten er registrert som underAvvikling |
Boolean |
true/false |
|
Tidligste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste stiftelsesdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste stiftelsesdato hos enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Enhetens organisasjonsform |
String |
Kommaseparert liste med organisajonsformer |
|
Enhetens hjemmeside |
String |
Fritekst |
|
Enhetens institusjonelle sektorkode |
String |
Kommaseparert liste med sektorkoder på 4 siffer |
|
Kommunenummer til enhetens postadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummeret til enhetens postadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til enhetens postadresse |
String |
Fritekst |
|
Landkode til enhetens postadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens postadresse |
String |
Kommaseparert liste med adresser |
|
Kommunenummeret til enhetens forretningsadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummer til enhetens forretningsadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til enhetens forretningsadresse |
String |
Fritekst |
|
Landkode til enhetens forretningsadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens forretningsadresse |
String |
Kommaseparert liste med adresser |
|
Enhetens næringskode |
Array |
Kommaseparert liste med næringskoder |
|
Årstall for siste innsendte årsregnskap for enheten |
String |
Kommaseparert liste med årstall på 4 siffer |
|
Sortering av resultatsett |
String |
Feltnavn i enheten. Se Eksempel 3 - Sortere søkeresultat |
|
Sidestørrelse |
Int |
Tall større enn 0 |
|
Sidenummer |
Int |
Tall større enn eller lik 0 |
| Path | Type | Description |
|---|---|---|
|
|
En liste av enheter som finnes i Enhetsregisteret |
|
|
Enhetens organisasjonsnummer |
|
|
Enhetens navn |
|
|
Enhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Enhetens hjemmeside |
|
|
Enhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Enhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt enheten er registrert i MVA-registeret |
|
|
Enheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Antall ansatte |
|
|
Organisasjonsnummeret til overordnet enhet i offentlig sektor |
|
|
Enhetens forretningsadresse |
|
|
Adresse (forretningsadresse) |
|
|
Postnummer (forretningsadresse) |
|
|
Poststed (forretningsadresse) |
|
|
Kommunenummer (forretningsadresse) |
|
|
Kommune (forretningsadresse) |
|
|
Landkode (forretningsadresse) |
|
|
Land (forretningsadresse) |
|
|
Enhetens stiftelsesdato |
|
|
Enhetens sektorkode |
|
|
Sektorkoden |
|
|
Tekstlig beskrivelse av sektorkoden |
|
|
Hvorvidt enheten er registrert i Foretaksregisteret |
|
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
|
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
|
|
Dato for siste innsendte årsregnskap |
|
|
Hvorvidt enheten er konkurs |
|
|
Hvorvidt enheten er under avvikling |
|
|
Hvorvidt enheten er under tvangsavvikling eller tvangsoppløsning |
|
|
Målform |
|
|
Lenke til egen ressurs |
|
|
Lenke til enhetens overordnede enhet i offentlig sektor |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til første side med resultater |
|
|
Lenke til forrige side med resultater |
|
|
Lenke til egen ressurs |
|
|
Lenke til neste side med resultater |
|
|
Lenke til siste side med resultater |
* Obligatorisk, feltet vil alltid være med i responsen.
| Path | Type | Description |
|---|---|---|
|
|
En liste av enheter som finnes i Enhetsregisteret |
|
|
Enhetens organisasjonsnummer |
|
|
Enhetens navn |
|
|
Enhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Enhetens hjemmeside |
|
|
Enhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Enhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt enheten er registrert i MVA-registeret |
|
|
Enheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Hjelpeenhetskode |
|
|
Hjelpeenhetskode |
|
|
Tekstlig beskrivelse av hjelpeenhetskode |
|
|
Antall ansatte |
|
|
Angir om enheten har registrert ansatte |
|
|
Organisasjonsnummeret til overordnet enhet i offentlig sektor |
|
|
Enhetens forretningsadresse |
|
|
Adresse (forretningsadresse) |
|
|
Postnummer (forretningsadresse) |
|
|
Poststed (forretningsadresse) |
|
|
Kommunenummer (forretningsadresse) |
|
|
Kommune (forretningsadresse) |
|
|
Landkode (forretningsadresse) |
|
|
Land (forretningsadresse) |
|
|
Enhetens stiftelsesdato |
|
|
Enhetens sektorkode |
|
|
Sektorkoden |
|
|
Tekstlig beskrivelse av sektorkoden |
|
|
Hvorvidt enheten er registrert i Foretaksregisteret |
|
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
|
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
|
|
Dato for siste innsendte årsregnskap |
|
|
Hvorvidt enheten er konkurs |
|
|
Kjennelsesdato for konkursen. Format: yyyy-MM-dd |
|
|
Hvorvidt enheten er under avvikling |
|
|
Hvorvidt enheten er under tvangsavvikling eller tvangsoppløsning |
|
|
Målform |
|
|
Lenke til egen ressurs |
|
|
Lenke til enhetens overordnede enhet i offentlig sektor |
|
|
Enhetens vedtektsdato. Format: yyyy-MM-dd |
|
|
Enhetens formål |
|
|
Enhetens aktivitet |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til første side med resultater |
|
|
Lenke til forrige side med resultater |
|
|
Lenke til egen ressurs |
|
|
Lenke til neste side med resultater |
|
|
Lenke til siste side med resultater |
* Obligatorisk, feltet vil alltid være med i responsen.
| Parameter | Description |
|---|---|
|
Enhetens navn |
|
Organisasjonsnummeret til enheten |
|
Organisasjonsnummeret til enhetens overordnede enhet |
|
Koden til organisasjonsformen |
|
Antall ansatte hos enheten |
|
Enhetens hjemmeside |
|
Kommunen til enhetens postadresse |
|
Kommunenummer til enhetens postadresse |
|
Registreringsdato i Enhetsregisteret |
|
Hvorvidt enheten er registrert i Mva-registeret |
|
Hvorvidt enheten er registrert i Foretaksregisteret |
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
|
Hvorvidt næringskoden har en hjelpeenhetskode |
|
Kode for enhetens næringskode |
|
Hvorvidt næringskoden har en hjelpeenhetskode |
|
Kode for enhetens næringskode |
|
Hvorvidt næringskoden har en hjelpeenhetskode |
|
Kode for enhetens næringskode |
|
Kommunen til enhetens forretningsadresse |
|
Kommunenummer til enhetens forretningsadresse |
|
Stiftelsesdato for enheten |
|
Enhetens institusjonelle sektorkode |
|
Hvorvidt enheten har gått konkurs |
|
Hvorvidt enheten er under avvikling |
|
Hvorvidt enheten er under tvangsavvikling eller tvansoppløsning |
| Parameter | Description |
|---|---|
|
Enhetens navn |
|
Organisasjonsnummeret til enheten |
|
Organisasjonsnummeret til enhetens overordnede enhet |
|
Koden til organisasjonsformen |
|
Antall ansatte hos enheten |
|
Enhetens hjemmeside |
|
Kommunen til enhetens postadresse |
|
Kommunenummer til enhetens postadresse |
|
Registreringsdato i Enhetsregisteret |
|
Hvorvidt enheten er registrert i Mva-registeret |
|
Hvorvidt enheten er registrert i Foretaksregisteret |
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
|
Kode for enhetens næringskode |
|
Kode for enhetens næringskode |
|
Kode for enhetens næringskode |
|
Kode for enhetens hjelpeenhetskode |
|
Kommunen til enhetens forretningsadresse |
|
Kommunenummer til enhetens forretningsadresse |
|
Stiftelsesdato for enheten |
|
Enhetens institusjonelle sektorkode |
|
Hvorvidt enheten har gått konkurs |
|
Hvorvidt enheten er under avvikling |
|
Hvorvidt enheten er under tvangsavvikling eller tvansoppløsning |
Paginering
Det er mulig å bla gjennom resultatsettet via page+size, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000. Ved oppslag på større enn 10 000 vil tjenesten returnere HTTP-status 400 med tilhørende feilmelding.
Dersom formålet med å bla dypt i tjenesten er å hente ut alle enheter, kan man i stedet benytte nedlastingstjenestene. Disse oppdateres en gang i døgnet. For å oppdatere enhetene kan man benytte oppdateringstjenesten, og videre gjøre enkeltoppslag på enhetene som har fått en endring.
Når overordnet enhet i offentlig sektor er slettet
Det kan forekomme at en hovedenhets overordnede enhet i offentlig sektor er slettet.
Hvis dette er relevant informasjon for deg, anbefaler vi at du gjør en ny forespørsel for å hente overordnet enhet. Da kan du sjekke om enheten er slettet ved å sjekke om slettedato er satt. Tips: Self-lenken viser hvor du kan hente overordnet enhet.
Hent en enhet
Eksempel 1 - Hent enhet (V1 - erstattes av V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/112233445' -i -X GETGET /enhetsregisteret/api/enheter/112233445 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1374
{
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}| Parameter | Description |
|---|---|
|
Enhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Enhetens organisasjonsnummer |
|
|
Enhetens navn |
|
|
Enhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Enhetens hjemmeside |
|
|
Enhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Enhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt enheten er registrert i MVA-registeret |
|
|
Enheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Antall ansatte |
|
|
Organisasjonsnummeret til overordnet enhet i offentlig sektor |
|
|
Enhetens forretningsadresse |
|
|
Adresse (forretningsadresse) |
|
|
Postnummer (forretningsadresse) |
|
|
Poststed (forretningsadresse) |
|
|
Kommunenummer (forretningsadresse) |
|
|
Kommune (forretningsadresse) |
|
|
Landkode (forretningsadresse) |
|
|
Land (forretningsadresse) |
|
|
Enhetens stiftelsesdato |
|
|
Enhetens sektorkode |
|
|
Sektorkoden |
|
|
Tekstlig beskrivelse av sektorkoden |
|
|
Hvorvidt enheten er registrert i Foretaksregisteret |
|
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
|
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
|
|
Dato for siste innsendte årsregnskap |
|
|
Hvorvidt enheten er konkurs |
|
|
Hvorvidt enheten er under avvikling |
|
|
Hvorvidt enheten er under tvangsavvikling eller tvangsoppløsning |
|
|
Målform |
|
|
Lenke til egen ressurs |
|
|
Lenke til enhetens overordnede enhet i offentlig sektor |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 2 - Hent enhet (V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/112233445' -i -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8'GET /enhetsregisteret/api/enheter/112233445 HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8
Content-Length: 1525
{
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"harRegistrertAntallAnsatte" : true,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"konkursdato" : "",
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"vedtektsdato" : "2017-10-21",
"vedtektsfestetFormaal" : [ "" ],
"aktivitet" : [ ],
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}| Parameter | Description |
|---|---|
|
Enhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Enhetens organisasjonsnummer |
|
|
Enhetens navn |
|
|
Enhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Enhetens hjemmeside |
|
|
Enhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Enhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt enheten er registrert i MVA-registeret |
|
|
Enheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Hjelpeenhetskode |
|
|
Hjelpeenhetskode |
|
|
Tekstlig beskrivelse av hjelpeenhetskode |
|
|
Antall ansatte |
|
|
Angir om enheten har registrert ansatte |
|
|
Organisasjonsnummeret til overordnet enhet i offentlig sektor |
|
|
Enhetens forretningsadresse |
|
|
Adresse (forretningsadresse) |
|
|
Postnummer (forretningsadresse) |
|
|
Poststed (forretningsadresse) |
|
|
Kommunenummer (forretningsadresse) |
|
|
Kommune (forretningsadresse) |
|
|
Landkode (forretningsadresse) |
|
|
Land (forretningsadresse) |
|
|
Enhetens stiftelsesdato |
|
|
Enhetens sektorkode |
|
|
Sektorkoden |
|
|
Tekstlig beskrivelse av sektorkoden |
|
|
Hvorvidt enheten er registrert i Foretaksregisteret |
|
|
Hvorvidt enheten er registrert i Stiftelsesregisteret |
|
|
Hvorvidt enheten er registrert i Frivillighetsregisteret |
|
|
Dato for siste innsendte årsregnskap |
|
|
Hvorvidt enheten er konkurs |
|
|
Kjennelsesdato for konkursen. Format: yyyy-MM-dd |
|
|
Hvorvidt enheten er under avvikling |
|
|
Hvorvidt enheten er under tvangsavvikling eller tvangsoppløsning |
|
|
Målform |
|
|
Lenke til egen ressurs |
|
|
Lenke til enhetens overordnede enhet i offentlig sektor |
|
|
Enhetens vedtektsdato. Format: yyyy-MM-dd |
|
|
Enhetens formål |
|
|
Enhetens aktivitet |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 3 - Hent en slettet enhet
Hvis en enhet er slettet vil responsen få statuskode 200 OK. HTTP Responsen vil da også inneholde færre attributter, som vist i eksempelet under.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/123456789' -i -X GETGET /enhetsregisteret/api/enheter/123456789 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 484
{
"organisasjonsnummer" : "123456789",
"navn" : "SLETTET ENHET AS",
"organisasjonsform" : {
"kode" : "UTBG",
"beskrivelse" : "Frivillig registrert utleiebygg",
"utgaatt" : "2017-07-17",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/UTBG"
}
}
},
"slettedato" : "2017-10-20",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/123456789"
}
}
}| Parameter | Description |
|---|---|
|
Den slettede enhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Organisasjonsnummer |
|
|
Organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Navn |
|
|
Nedleggelsesdato for underenheten |
|
|
Dato under-/enheten ble slettet |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 4 - Hent en fjernet enhet
En enhet kan fjernes fra avgivelsen fra Enhetsregisteret for eksempel av juridiske årsaker. Hvis en enhet er fjernet vil denne få statuskode 410 Gone. Dette bør også anses som en forespørsel om at eventuelle kopier/cacher også fjerner den aktuelle enheten.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/900111222' -i -X GETGET /enhetsregisteret/api/enheter/900111222 HTTP/1.1
Host: data.brreg.noHTTP/1.1 410 Gone
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 186
{
"organisasjonsnummer" : "900111222",
"slettedato" : "2022-08-06",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/900111222"
}
}
}| Parameter | Description |
|---|---|
|
Den fjernede enhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Organisasjonsnummer |
|
|
Dato under-/enheten ble fjernet |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Hent alle roller for en enhet
I dette endepunktet kan du hente alle roller for en enhet gjennom oppslag med organisasjonsnummer.
|
Opplysninger om at en person er registrert med en rolle, som for eksempel styremedlem, er åpne offentlige data. Men ønsker du å sette opp en oversikt over hvilke roller en person har i andre virksomheter, har du kun lov å vise roller knyttet til næringsvirksomhet. Det betyr at personens registrerte rolle i en frivillig organisasjon ikke kan vises med personens roller i for eksempel et aksjeselskap. Aktuelt regelverk: § 22 i enhetsregisterloven. |
404 Ikke funnet
| Ressursen finnes ikke. Det kan bety at enheten ikke eksisterer, eller at enheten ikke har roller. |
Eksempel 1 - Person som rolleinnehaver
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/810004622/roller' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/enheter/810004622/roller HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1291
{
"rollegrupper" : [ {
"type" : {
"kode" : "STYR",
"beskrivelse" : "Styre",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/STYR"
}
}
},
"sistEndret" : "2019-01-01",
"roller" : [ {
"type" : {
"kode" : "LEDE",
"beskrivelse" : "Styrets leder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/LEDE"
}
}
},
"person" : {
"fodselsdato" : "1981-01-01",
"navn" : {
"fornavn" : "Ove",
"etternavn" : "Olsen"
},
"erDoed" : false
},
"valgtAv" : {
"kode" : "A-AK",
"beskrivelse" : "Representant for A-aksjonærene",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter/A-AK"
}
}
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
} ],
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810004622/roller"
},
"enhet" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810004622"
}
}
}Eksempel 2 - Person med verge som rolleinnehaver
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/810003952/roller' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/enheter/810003952/roller HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1221
{
"rollegrupper" : [ {
"type" : {
"kode" : "STYR",
"beskrivelse" : "Styre",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/STYR"
}
}
},
"sistEndret" : "2019-01-01",
"roller" : [ {
"type" : {
"kode" : "LEDE",
"beskrivelse" : "Styrets leder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/LEDE"
}
}
},
"person" : {
"fodselsdato" : "1980-01-01",
"navn" : {
"fornavn" : "Bendik",
"etternavn" : "Olsen"
},
"erDoed" : false,
"verge" : {
"fodselsdato" : "1981-01-01",
"navn" : {
"fornavn" : "Ove",
"etternavn" : "Olsen"
},
"erDoed" : false
}
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
} ],
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810003952/roller"
},
"enhet" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810003952"
}
}
}Eksempel 3 - Enheter som rolleinnehavere
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/810005912/roller' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/enheter/810005912/roller HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 2362
{
"rollegrupper" : [ {
"type" : {
"kode" : "DELT",
"beskrivelse" : "Deltakere",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/DELT"
}
}
},
"sistEndret" : "2021-02-01",
"roller" : [ {
"type" : {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med delt ansvar",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810006242",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Rolfsens Deltakerorganisasjon AS" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810006242"
}
}
},
"ansvarsandel" : "50%",
"fratraadt" : false,
"rekkefolge" : 0
}, {
"type" : {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med delt ansvar",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810004282",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Sult AS" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810004282"
}
}
},
"ansvarsandel" : "50%",
"fratraadt" : false,
"rekkefolge" : 1
} ]
} ],
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810005912/roller"
},
"enhet" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810005912"
}
}
}Eksempel 4 - Multiple rollegrupper - Ansvarlig selskap med delt ansvar (DA)
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/910063367/roller' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/enheter/910063367/roller HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 10044
{
"rollegrupper" : [ {
"type" : {
"kode" : "DAGL",
"beskrivelse" : "Daglig leder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/DAGL"
}
}
},
"sistEndret" : "2020-11-06",
"roller" : [ {
"type" : {
"kode" : "DAGL",
"beskrivelse" : "Daglig leder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DAGL"
}
}
},
"person" : {
"fodselsdato" : "1990-11-11",
"navn" : {
"fornavn" : "Lise",
"etternavn" : "Olsen"
},
"erDoed" : false
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
}, {
"type" : {
"kode" : "STYR",
"beskrivelse" : "Styre",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/STYR"
}
}
},
"sistEndret" : "2021-01-02",
"roller" : [ {
"type" : {
"kode" : "LEDE",
"beskrivelse" : "Styrets leder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/LEDE"
}
}
},
"person" : {
"fodselsdato" : "1965-05-05",
"navn" : {
"fornavn" : "Harald",
"etternavn" : "Haraldson"
},
"erDoed" : false
},
"fratraadt" : false,
"rekkefolge" : 0
}, {
"type" : {
"kode" : "NEST",
"beskrivelse" : "Nestleder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/NEST"
}
}
},
"person" : {
"fodselsdato" : "1975-10-07",
"navn" : {
"fornavn" : "Randi",
"etternavn" : "Randida"
},
"erDoed" : false
},
"fratraadt" : false,
"rekkefolge" : 1
}, {
"type" : {
"kode" : "MEDL",
"beskrivelse" : "Styremedlem",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/MEDL"
}
}
},
"person" : {
"fodselsdato" : "1968-07-07",
"navn" : {
"fornavn" : "Marit",
"etternavn" : "Bertheussen"
},
"erDoed" : false
},
"fratraadt" : true,
"rekkefolge" : 2
}, {
"type" : {
"kode" : "MEDL",
"beskrivelse" : "Styremedlem",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/MEDL"
}
}
},
"person" : {
"fodselsdato" : "1905-05-11",
"navn" : {
"fornavn" : "Guttorm",
"etternavn" : "Hansen"
},
"erDoed" : false,
"verge" : {
"fodselsdato" : "1975-02-21",
"navn" : {
"fornavn" : "Jens",
"mellomnavn" : "Erlend",
"etternavn" : "Hansen"
},
"erDoed" : false
}
},
"fratraadt" : false,
"rekkefolge" : 3
}, {
"type" : {
"kode" : "MEDL",
"beskrivelse" : "Styremedlem",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/MEDL"
}
}
},
"person" : {
"fodselsdato" : "1928-05-05",
"navn" : {
"fornavn" : "Olav",
"etternavn" : "Haraldson"
},
"erDoed" : true
},
"fratraadt" : false,
"rekkefolge" : 4
} ]
}, {
"type" : {
"kode" : "DELT",
"beskrivelse" : "Deltakere",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/DELT"
}
}
},
"sistEndret" : "2020-12-01",
"roller" : [ {
"type" : {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med delt ansvar",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
},
"person" : {
"fodselsdato" : "1991-03-03",
"navn" : {
"fornavn" : "Lars",
"mellomnavn" : "Magne",
"etternavn" : "Magnusson"
},
"erDoed" : false
},
"ansvarsandel" : "25%",
"fratraadt" : false,
"rekkefolge" : 0
}, {
"type" : {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med delt ansvar",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810006072",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Hansen & Brunsen AS" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810006072"
}
}
},
"ansvarsandel" : "25%",
"fratraadt" : false,
"fullmektige" : [ {
"navn" : "Mr Fullmektig",
"adresse" : [ "Fullmektigveien 1", "0001 Oslo" ]
} ],
"rekkefolge" : 1
}, {
"type" : {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med delt ansvar",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810004312",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Slettet deltakerorganisasjon AS" ],
"erSlettet" : true,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810004312"
}
}
},
"ansvarsandel" : "25%",
"fratraadt" : false,
"rekkefolge" : 2
}, {
"type" : {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med delt ansvar",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810004762",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Fratrådt Nilsen AS." ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810004762"
}
}
},
"ansvarsandel" : "25%",
"fratraadt" : true,
"rekkefolge" : 3
} ]
}, {
"type" : {
"kode" : "REVI",
"beskrivelse" : "Revisor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/REVI"
}
}
},
"sistEndret" : "2021-02-03",
"roller" : [ {
"type" : {
"kode" : "REVI",
"beskrivelse" : "Revisor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/REVI"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810007192",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Revisormesterne AS" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810007192"
}
}
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
}, {
"type" : {
"kode" : "REGN",
"beskrivelse" : "Regnskapsfører",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/REGN"
}
}
},
"sistEndret" : "2021-02-03",
"roller" : [ {
"type" : {
"kode" : "REGN",
"beskrivelse" : "Regnskapsfører",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/REGN"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810007052",
"organisasjonsform" : {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonsforetak",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
},
"navn" : [ "Ultra Regnskapsfører" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810007052"
}
}
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
} ],
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/910063367/roller"
},
"enhet" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/910063367"
}
}
}Eksempel 5 - Multiple rollegrupper - Enkeltpersonsforetak (ENK)
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/910313517/roller' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/enheter/910313517/roller HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 3384
{
"rollegrupper" : [ {
"type" : {
"kode" : "INNH",
"beskrivelse" : "Innehaver",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/INNH"
}
}
},
"sistEndret" : "2020-11-06",
"roller" : [ {
"type" : {
"kode" : "INNH",
"beskrivelse" : "Innehaver",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/INNH"
}
}
},
"person" : {
"fodselsdato" : "1985-12-06",
"navn" : {
"fornavn" : "Karl",
"mellomnavn" : "Karlos",
"etternavn" : "Karlson"
},
"erDoed" : false
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
}, {
"type" : {
"kode" : "REVI",
"beskrivelse" : "Revisor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/REVI"
}
}
},
"sistEndret" : "2021-02-03",
"roller" : [ {
"type" : {
"kode" : "REVI",
"beskrivelse" : "Revisor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/REVI"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810007192",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"navn" : [ "Revisormesterne AS" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810007192"
}
}
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
}, {
"type" : {
"kode" : "REGN",
"beskrivelse" : "Regnskapsfører",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/REGN"
}
}
},
"sistEndret" : "2021-02-03",
"roller" : [ {
"type" : {
"kode" : "REGN",
"beskrivelse" : "Regnskapsfører",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/REGN"
}
}
},
"enhet" : {
"organisasjonsnummer" : "810007052",
"organisasjonsform" : {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonsforetak",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
},
"navn" : [ "Ultra Regnskapsfører" ],
"erSlettet" : false,
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/810007052"
}
}
},
"fratraadt" : false,
"rekkefolge" : 0
} ]
} ],
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/910313517/roller"
},
"enhet" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter/910313517"
}
}
}Eksempel 6 - Feilaktig forespørsel
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/9ECD01011/roller' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/enheter/9ECD01011/roller HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 400 Bad Request
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 367
{
"tidsstempel" : 1622200011303,
"status" : 400,
"feilmelding" : "Feilaktig forespørsel",
"sti" : "/enhetsregisteret/api/enheter/9ECD01011/roller",
"antallFeil" : 1,
"valideringsfeil" : [ {
"feilmelding" : "Organisasjonsnummer må være et nummer med nøyaktig 9 siffer",
"parametere" : [ "9ECD01011" ],
"feilaktigVerdi" : "9ECD01011"
} ]
}Detaljer
Om tjenesten
Responsfelt er felles for alle "200 - OK"-responser i denne tjenesten.
| Parameter | Description |
|---|---|
|
Organisasjonsnummeret til enheten |
| Path | Type | Description |
|---|---|---|
|
|
Liste med rollegrupper knyttet til enheten |
|
|
Rollegruppe |
|
|
Rollegruppetype, og beskrivelse av typen |
|
|
Kode for rollegruppetype |
|
|
Beskrivelse av rollegruppetypen |
|
|
Lenke for rollegruppetype |
|
|
|
|
|
Self-link for rollegruppetype |
|
|
Dato for siste endring |
|
|
Liste med alle rollene i gruppen |
|
|
Rolle tilknyttet person eller enhet |
|
|
Rolletype, og beskrivelse av typen |
|
|
Kode for rolletype |
|
|
Beskrivelse av rolletypen |
|
|
Lenke for rolletype |
|
|
|
|
|
Self-link for rolletype |
|
|
|
|
|
Personens fødselsdato |
|
|
Personens fulle navn |
|
|
Personens fornavn |
|
|
Personens mellomnavn |
|
|
Personens etternavn |
|
|
|
|
|
Vergens fødselsdato |
|
|
Vergens fulle navn |
|
|
Vergens fornavn |
|
|
Vergens mellomnavn |
|
|
Vergens etternavn |
|
|
Om hvorvidt vergen er død |
|
|
Om hvorvidt personen er død |
|
|
Enhet som innehar rolle |
|
|
Unik id-nummer tilhørende enheten |
|
|
Organisasjonsformen til enheten |
|
|
Kode til organisasjonsformen |
|
|
Beskrivelse av organisasjonsformen |
|
|
Dato for om organisasjonsformen er utgått |
|
|
Lenke for organisasjonsform |
|
|
|
|
|
Self-link for organisasjonsform |
|
|
Enhetens navn |
|
|
Navn |
|
|
Om hvorvidt enheten er slettet |
|
|
Lenker for tilknyttet enhet |
|
|
|
|
|
Self-link for tilknyttet enhet |
|
|
Rollens ansvarsandel for selskapets forpliktelser, i brøk eller prosent |
|
|
Kode og beskrivelse av hvem rollen representerer (ikke innehaver) |
|
|
Kode |
|
|
Beskrivelse tilknyttet koden |
|
|
Lenker for representant |
|
|
|
|
|
Self-link for representant |
|
|
Fratrådt fra rolle |
|
|
Liste over fullmektige |
|
|
Fullmektig, med navn og adresser |
|
|
Navn på fullmektig |
|
|
Adresser/adresselinjer knyttet til fullmektig |
|
|
Adresse/adresselinje |
|
|
Rekkefølgen på rollen i gruppen |
|
|
Lenker knyttet til resultatet |
|
|
|
|
|
Self-link for resultatet |
|
|
|
|
|
Lenke for å hente ut data om selve enheten |
* Obligatorisk, feltet vil alltid være med i responsen.
Last ned enheter
Eksempel 1 - Last ned alle enheter i json-format (V1 - erstattes av V2)
Alle enheter kan lastes ned i en fil komprimert med gzip. Formatet på denne filen er i forenklet json, og vil ikke inkludere lenker som i HAL formatet. Filen produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned' -X GET -J -OGET /enhetsregisteret/api/enheter/lastned HTTP/1.1
Host: data.brreg.noEksempel 2 - Last ned alle enheter i json-format (V2)
Alle enheter kan lastes ned i en fil komprimert med gzip. Formatet på denne filen er i forenklet json, og vil ikke inkludere lenker som i HAL formatet. Filen produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned' -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+gzip;charset=UTF-8' -J -OGET /enhetsregisteret/api/enheter/lastned HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+gzip;charset=UTF-8
Host: data.brreg.noEksempel 3 - Last ned alle enheter i csv
Alle enheter i csv format kan lastes ned til en fil komprimert med gzip. Filene produseres hver natt, cirka klokken 0500.
Vi anbefaler å bruke kolonnenavnene til å identifisere informasjonselementene, da det kan være at vi setter inn nye kolonner eller endrer rekkefølgen. Det er derfor best å unngå å bruke indeks/posisjon for kolonne når du leser csv-filen.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned/csv' -X GET -J -OGET /enhetsregisteret/api/enheter/lastned/csv HTTP/1.1
Host: data.brreg.noEksempel 4 - Last ned alle enheter i xlsx (V1 - erstattes av V2)
Alle enheter kan lastes ned til fil på xlsx-format. Filene produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned/regneark' -X GET -J -OGET /enhetsregisteret/api/enheter/lastned/regneark HTTP/1.1
Host: data.brreg.noEksempel 5 - Last ned alle enheter i xlsx (V2)
Alle enheter kan lastes ned til fil på xlsx-format. Filene produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned/regneark' -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=UTF-8' -J -OGET /enhetsregisteret/api/enheter/lastned/regneark HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=UTF-8
Host: data.brreg.noEksempel 6 - Last ned søkeresultat
Resultatsettet av en spørring kan lastes ned i en fil komprimert med gzip. Formatet på denne filen er i forenklet json, og vil ikke inkludere lenker som i HAL formatet. Resultatfilen vil ha oppdaterte enheter, men er begrenset til 10.000 enheter. Hvis resultatsettet overstiger begrensningen, vil de siste enhetene ekskluderes fra filen.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned?navn=Sesam' -X GET -J -OGET /enhetsregisteret/api/enheter/lastned?navn=Sesam HTTP/1.1
Host: data.brreg.noEksempel 7 - Sjekk filstørrelsen uten å laste ned hele fila
Du kan sjekke filstørrelsen ved å benytte HTTP-verbet HEAD. Filstørrelsen kan du lese fra Content-Length headeren i responsen. I dette APIet støtter vi HEAD på alle URLer med filnedlasting.
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter/lastned/regneark' --headHEAD /enhetsregisteret/api/enheter/lastned/regneark HTTP/1.1
Host: data.brreg.noDetaljer
-
Se sortering for enheter
-
Se feilmelding for enheter
-
Se navnesøk for enheter
Hente ut oppdaterte enheter
Tjenesten tilbyr et søk på nylige oppdaterte enheter i Enhetsregisteret. Søket kan spesifiseres med et søkeparameter angitt som et HTTP query-parameter, se beskrivelse. Maks antall parametre er 1024. Søkeresultatet er paginert med en standard sidestørrelse på 20 enheter.
Endringstyper
| Type | Beskrivelse |
|---|---|
Ukjent |
Ukjent type endring. Ofte fordi endringen har skjedd før endringstype ble innført. |
Ny |
Enheten har blitt lagt til i Enhetsregisteret |
Endring |
Enheten har blitt endret i Enhetsregisteret |
Sletting |
Enheten har blitt slettet fra Enhetsregisteret |
Fjernet |
Enheten har blitt fjernet fra Åpne Data. Eventuelle kopier skal også fjerne enheten. |
Detaljer
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Vis bare oppdateringer fra og med dette tidsstempelet. Tidsstempelet indikerer når oppdateringen ble offentliggjort i dette APIet |
String |
Datetime (ISO-8601): yyyy-MM-dd’T’HH:mm:ss.SSS’Z' |
|
Vis bare oppdateringer fra og med oppdateringsid |
Integer |
Større eller lik 1 |
|
Vis bare oppdateringer på gitte organisasjonsnummer |
String |
Kommaseparert liste med organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
En liste av oppdaterte enheter |
|
|
Sekvensiell oppdateringsid for enhet. |
|
|
Tidsstempel for når endringen på enheten ble offentliggjort i dette APIet |
|
|
Enhetens organisasjonsnummer. |
|
|
Type endring som ble gjennomført |
|
|
Lenke til enhet |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til første side med resultater |
|
|
Lenke til forrige side med resultater |
|
|
Lenke til egen ressurs |
|
|
Lenke til neste side med resultater |
|
|
Lenke til siste side med resultater |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 1 - Hent alle oppdateringer
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter' -i -X GETGET /enhetsregisteret/api/oppdateringer/enheter HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 851
{
"_embedded" : {
"oppdaterteEnheter" : [ {
"oppdateringsid" : 1,
"dato" : "2010-01-02T00:00:00.000Z",
"organisasjonsnummer" : "123456789",
"endringstype" : "Ukjent",
"_links" : {
"enhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/123456789"
}
}
}, {
"oppdateringsid" : 2,
"dato" : "2010-01-03T00:00:00.000Z",
"organisasjonsnummer" : "987654321",
"endringstype" : "Ny",
"_links" : {
"enhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/987654321"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 2 - Hent alle oppdateringer etter gitt dato
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter?dato=2010-01-03T00:00:00.000Z' -i -X GETGET /enhetsregisteret/api/oppdateringer/enheter?dato=2010-01-03T00:00:00.000Z HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 596
{
"_embedded" : {
"oppdaterteEnheter" : [ {
"oppdateringsid" : 2,
"dato" : "2010-01-03T00:00:00.000Z",
"organisasjonsnummer" : "987654321",
"endringstype" : "Fjernet",
"_links" : {
"enhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/987654321"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter?dato=2010-01-03T00:00:00.000Z"
}
},
"page" : {
"size" : 2,
"totalElements" : 1,
"totalPages" : 1,
"number" : 0
}
}Eksempel 3 - Hent alle oppdateringer etter gitt oppdateringsid
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter?oppdateringsid=2' -i -X GETGET /enhetsregisteret/api/oppdateringer/enheter?oppdateringsid=2 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 583
{
"_embedded" : {
"oppdaterteEnheter" : [ {
"oppdateringsid" : 2,
"dato" : "2010-01-03T00:00:00.000Z",
"organisasjonsnummer" : "987654321",
"endringstype" : "Fjernet",
"_links" : {
"enhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/987654321"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter?oppdateringsid=2"
}
},
"page" : {
"size" : 2,
"totalElements" : 1,
"totalPages" : 1,
"number" : 0
}
}Paginering
Det er mulig å filtrere og bla gjennom resultatsettet via page+size, dato og/eller updateid, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000 og det kan finnes flere elementer med samme dato. Updateid kan bare forekomme en gang, men disse er gjenbrukt på tvers av underenheter og enheter og kan ha gap på flere tusen id’er.
Vi anbefaler følgende bruk: Filtrer på dato for første gangs uthenting, slik at man unngår enheter tidligere enn eventuell siste kopi. Filtrer så på updateid for å hente neste sett av resultater. (Her kan man trygt bruke updateid+1). Page+size kan benyttes for mer presis navigering i en updateid- eller dato-spørring.
Underenheter
Søk etter underenheter
Tjenesten tilbyr et søk på underenheter i Enhetsregisteret. Søket kan spesifiseres med søkeparametere angitt som HTTP query-parametere, se beskrivelse. Søkeresultatet er paginert med en standard sidestørrelse på 20 enheter.
|
Resultatsettet er begrenset til 10 000 underenheter per spørring. Se underenheter/lastned for nedlasting av komplett datasett. |
Eksempel 1 - Hent alle underenheter (V1 - erstattes av V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter' -i -X GETGET /enhetsregisteret/api/underenheter HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 2890
{
"_embedded" : {
"underenheter" : [ {
"organisasjonsnummer" : "334455660",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"antallAnsatte" : 0,
"overordnetEnhet" : "443322119",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/334455660"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
}, {
"organisasjonsnummer" : "811581712",
"navn" : "360 GRADER KIROPRAKTOR AS",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0722",
"poststed" : "NØTTERØY",
"adresse" : [ "Lundgaardveien 1A" ],
"kommune" : "NØTTERØY",
"kommunenummer" : "3120"
},
"registreringsdatoEnhetsregisteret" : "2013-02-18",
"registrertIMvaregisteret" : false,
"naeringskode1" : {
"kode" : "86.909",
"beskrivelse" : "En kode"
},
"antallAnsatte" : 5,
"overordnetEnhet" : "911566826",
"oppstartsdato" : "2013-01-01",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0716",
"poststed" : "OSLO",
"adresse" : [ "Næringsbygget Industriveien 2A" ],
"kommune" : "REVETAL",
"kommunenummer" : "3174"
},
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/811581712"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/911566826"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 2 - Hent alle underenheter (V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter' -i -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+json;charset=UTF-8'GET /enhetsregisteret/api/underenheter HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+json;charset=UTF-8
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/vnd.brreg.enhetsregisteret.underenhet.v2+json;charset=UTF-8
Content-Length: 2950
{
"_embedded" : {
"underenheter" : [ {
"organisasjonsnummer" : "334455660",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"harRegistrertAntallAnsatte" : false,
"overordnetEnhet" : "443322119",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/334455660"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
}, {
"organisasjonsnummer" : "811581712",
"navn" : "360 GRADER KIROPRAKTOR AS",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0722",
"poststed" : "NØTTERØY",
"adresse" : [ "Lundgaardveien 1A" ],
"kommune" : "NØTTERØY",
"kommunenummer" : "3120"
},
"registreringsdatoEnhetsregisteret" : "2013-02-18",
"registrertIMvaregisteret" : false,
"naeringskode1" : {
"kode" : "86.909",
"beskrivelse" : "En kode"
},
"antallAnsatte" : 5,
"harRegistrertAntallAnsatte" : true,
"overordnetEnhet" : "911566826",
"oppstartsdato" : "2013-01-01",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0716",
"poststed" : "OSLO",
"adresse" : [ "Næringsbygget Industriveien 2A" ],
"kommune" : "REVETAL",
"kommunenummer" : "3174"
},
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/811581712"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/911566826"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 3 - Søk etter underenheter
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2015-01-01&naeringskode=90.012' -i -X GETGET /enhetsregisteret/api/underenheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2015-01-01&naeringskode=90.012 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 2092
{
"_embedded" : {
"underenheter" : [ {
"organisasjonsnummer" : "334455660",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"antallAnsatte" : 0,
"overordnetEnhet" : "443322119",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/334455660"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
} ]
},
"_links" : {
"first" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2015-01-01&naeringskode=90.012&page=0&size=1"
},
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2015-01-01&naeringskode=90.012"
},
"next" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2015-01-01&naeringskode=90.012&page=1&size=1"
},
"last" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter?navn=Sesam&fraRegistreringsdatoEnhetsregisteret=2015-01-01&naeringskode=90.012&page=1&size=1"
}
},
"page" : {
"size" : 1,
"totalElements" : 2,
"totalPages" : 2,
"number" : 0
}
}Detaljer
-
Se sortering for enheter
-
Se feilmelding for enheter
Om tjenesten
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Underenhetens navn |
String |
Fritekst |
|
Organisasjonsnummeret til underenheten |
String |
Kommaseparert liste med organisasjonsnummer |
|
Organisasjonsnummeret til underenhetens overordnede enhet |
String |
Streng med 9 siffer |
|
Minste antall ansatte hos underenheten |
Int |
Tall større enn eller lik 0 |
|
Største antall ansatte hos underenheten |
Int |
Tall større enn eller lik 0 |
|
Hvorvidt underenheten er registrert i Mva-registeret |
Boolean |
true/false |
|
Tidligste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste oppstartsdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste oppstartsdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste registreringsdato for eierskifte |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste registreringsdato for eierskifte |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste nedleggelsesdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste nedleggelsesdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Underenhetens organisasjonsform |
String |
Kommaseparert liste med organisajonsformer |
|
Enhetens hjemmeside |
String |
Fritekst |
|
Kommunenummer til underenhetens postadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummeret til underenhetens postadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til underenhetens postadresse |
String |
Fritekst |
|
Landkode til enhetens postadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens postadresse |
String |
Kommaseparert liste med adresser |
|
Kommunenummeret til underenhetens beliggenhetsadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummeret til underenhetens beliggenhetsadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til underenhetens beliggenhetsadresse |
String |
Fritekst |
|
Landkode til enhetens beliggenhetsadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens beliggenhetsadresse |
String |
Kommaseparert liste med adresser |
|
Underenhetens næringskode |
Array |
Kommaseparert liste med næringskoder |
|
Sortering av resultatsett |
String |
Feltnavn i underenheten. Se Eksempel 3 - Sortere søkeresultat |
|
Sidestørrelse |
Int |
Tall større enn 0 |
|
Sidenummer |
Int |
Tall større enn eller lik 0 |
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Underenhetens navn |
String |
Fritekst |
|
Organisasjonsnummeret til underenheten |
String |
Kommaseparert liste med organisasjonsnummer |
|
Organisasjonsnummeret til underenhetens overordnede enhet |
String |
Streng med 9 siffer |
|
Minste antall ansatte hos underenheten |
Int |
Tall må være 0, 1 eller større enn 4 |
|
Største antall ansatte hos underenheten |
Int |
Tall må være 0, 4, eller over 4 |
|
Hvorvidt underenheten er registrert i Mva-registeret |
Boolean |
true/false |
|
Tidligste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste registreringsdato i Enhetsregisteret |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste oppstartsdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste oppstartsdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste registreringsdato for eierskifte |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste registreringsdato for eierskifte |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Tidligste nedleggelsesdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Seneste nedleggelsesdato for enheten |
String |
Dato (ISO-8601): yyyy-MM-dd |
|
Underenhetens organisasjonsform |
String |
Kommaseparert liste med organisajonsformer |
|
Enhetens hjemmeside |
String |
Fritekst |
|
Kommunenummer til underenhetens postadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummeret til underenhetens postadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til underenhetens postadresse |
String |
Fritekst |
|
Landkode til enhetens postadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens postadresse |
String |
Kommaseparert liste med adresser |
|
Kommunenummeret til underenhetens beliggenhetsadresse |
String |
Kommaseparert liste med kommunenummer på 4 siffer |
|
Postnummeret til underenhetens beliggenhetsadresse |
String |
Kommaseparert liste med postnummer på 4 siffer |
|
Poststedet til underenhetens beliggenhetsadresse |
String |
Fritekst |
|
Landkode til enhetens beliggenhetsadresse |
String |
Kommaseparert liste med landkoder |
|
Adresse til enhetens beliggenhetsadresse |
String |
Kommaseparert liste med adresser |
|
Underenhetens næringskode |
Array |
Kommaseparert liste med næringskoder |
|
Sortering av resultatsett |
String |
Feltnavn i underenheten. Se Eksempel 3 - Sortere søkeresultat |
|
Sidestørrelse |
Int |
Tall større enn 0 |
|
Sidenummer |
Int |
Tall større enn eller lik 0 |
| Path | Type | Description |
|---|---|---|
|
|
En liste av underenheter som finnes i Enhetsregisteret |
|
|
Underenhetens organisasjonsnummer |
|
|
Underenhetens navn |
|
|
Underenhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Underenhetens hjemmeside |
|
|
Underenhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Underenhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt underenheten er registrert i MVA-registeret |
|
|
Underenheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Antall ansatte |
|
|
Underenhetens overordnede enhet |
|
|
Underenhetens beliggenhetsadresse |
|
|
Adresse (beliggenhetsadresse) |
|
|
Postnummer (beliggenhetsadresse) |
|
|
Poststed (beliggenhetsadresse) |
|
|
Kommunenummer (beliggenhetsadresse) |
|
|
Kommune (beliggenhetsadresse) |
|
|
Landkode (beliggenhetsadresse) |
|
|
Land (beliggenhetsadresse) |
|
|
Underenhetens oppstartsdato |
|
|
Underenhetens dato for eierskifte |
|
|
Nedleggelsesdato for underenheten |
|
|
Lenke til egen ressurs |
|
|
Lenke til underenhetens overordnede enhet |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til første side med resultater |
|
|
Lenke til forrige side med resultater |
|
|
Lenke til egen ressurs |
|
|
Lenke til neste side med resultater |
|
|
Lenke til siste side med resultater |
* Obligatorisk, feltet vil alltid være med i responsen.
| Path | Type | Description |
|---|---|---|
|
|
En liste av underenheter som finnes i Enhetsregisteret |
|
|
Underenhetens organisasjonsnummer |
|
|
Underenhetens navn |
|
|
Underenhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Underenhetens hjemmeside |
|
|
Underenhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Underenhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt underenheten er registrert i MVA-registeret |
|
|
Underenheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Hjelpeenhetskode |
|
|
Hjelpeenhetskode |
|
|
Tekstlig beskrivelse av hjelpeenhetskode |
|
|
Antall ansatte |
|
|
Angir om enheten har registrert ansatte |
|
|
Underenhetens overordnede enhet |
|
|
Underenhetens beliggenhetsadresse |
|
|
Adresse (beliggenhetsadresse) |
|
|
Postnummer (beliggenhetsadresse) |
|
|
Poststed (beliggenhetsadresse) |
|
|
Kommunenummer (beliggenhetsadresse) |
|
|
Kommune (beliggenhetsadresse) |
|
|
Landkode (beliggenhetsadresse) |
|
|
Land (beliggenhetsadresse) |
|
|
Underenhetens oppstartsdato |
|
|
Underenhetens dato for eierskifte |
|
|
Nedleggelsesdato for underenheten |
|
|
Lenke til egen ressurs |
|
|
Lenke til underenhetens overordnede enhet |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til første side med resultater |
|
|
Lenke til forrige side med resultater |
|
|
Lenke til egen ressurs |
|
|
Lenke til neste side med resultater |
|
|
Lenke til siste side med resultater |
* Obligatorisk, feltet vil alltid være med i responsen.
| Parameter | Description |
|---|---|
|
Enhetens navn |
|
Organisasjonsnummeret til enheten |
|
Organisasjonsnummeret til enhetens overordnede enhet |
|
Koden til organisasjonsformen |
|
Antall ansatte hos enheten |
|
Enhetens hjemmeside |
|
Kommunen til enhetens postadresse |
|
Kommunenummer til enhetens postadresse |
|
Registreringsdato i Enhetsregisteret |
|
Hvorvidt enheten er registrert i Mva-registeret |
|
Hvorvidt næringskoden har en hjelpeenhetskode |
|
Kode for enhetens næringskode |
|
Hvorvidt næringskoden har en hjelpeenhetskode |
|
Kode for enhetens næringskode |
|
Hvorvidt næringskoden har en hjelpeenhetskode |
|
Kode for enhetens næringskode |
|
Oppstartsdato for enheten |
|
Nedleggelsesdato for enheten |
|
Dato enheten skiftet eier |
|
Hvorvidt enheten har blitt slettet |
|
Dato enheten ble slettet |
|
Kommunen til enhetens beliggenhetsadresse |
|
Kommunenummer til enhetens beliggenhetsadresse |
| Parameter | Description |
|---|---|
|
Enhetens navn |
|
Organisasjonsnummeret til enheten |
|
Organisasjonsnummeret til enhetens overordnede enhet |
|
Koden til organisasjonsformen |
|
Antall ansatte hos enheten |
|
Enhetens hjemmeside |
|
Kommunen til enhetens postadresse |
|
Kommunenummer til enhetens postadresse |
|
Registreringsdato i Enhetsregisteret |
|
Hvorvidt enheten er registrert i Mva-registeret |
|
Kode for enhetens næringskode |
|
Kode for enhetens næringskode |
|
Kode for enhetens næringskode |
|
Kode for enhetens hjelpeenhetskode |
|
Oppstartsdato for enheten |
|
Nedleggelsesdato for enheten |
|
Dato enheten skiftet eier |
|
Hvorvidt enheten har blitt slettet |
|
Dato enheten ble slettet |
|
Kommunen til enhetens beliggenhetsadresse |
|
Kommunenummer til enhetens beliggenhetsadresse |
Paginering
Det er mulig å bla gjennom resultatsettet via page+size, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000. Ved oppslag på større enn 10 000 vil tjenesten returnere HTTP-status 400 med tilhørende feilmelding.
Dersom formålet med å bla dypt i tjenesten er å hente ut alle enheter, kan man i stedet benytte nedlastingstjenestene. Disse oppdateres en gang i døgnet. For å oppdatere enhetene kan man benytte oppdateringstjenesten, og videre gjøre enkeltoppslag på enhetene som har fått en endring.
Hent en underenhet
Eksempel 1 - Hent underenhet (V1 - erstattes av V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/776655441' -i -X GETGET /enhetsregisteret/api/underenheter/776655441 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1253
{
"organisasjonsnummer" : "776655441",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"overordnetEnhet" : "112233445",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"nedleggelsesdato" : "2018-10-20",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/776655441"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}| Parameter | Description |
|---|---|
|
Enhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Underenhetens organisasjonsnummer |
|
|
Underenhetens navn |
|
|
Underenhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Underenhetens hjemmeside |
|
|
Underenhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Underenhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt underenheten er registrert i MVA-registeret |
|
|
Underenheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Beskriver om dette er en hjelpeenhetskode (Ordbok) |
|
|
Antall ansatte |
|
|
Underenhetens overordnede enhet |
|
|
Underenhetens beliggenhetsadresse |
|
|
Adresse (beliggenhetsadresse) |
|
|
Postnummer (beliggenhetsadresse) |
|
|
Poststed (beliggenhetsadresse) |
|
|
Kommunenummer (beliggenhetsadresse) |
|
|
Kommune (beliggenhetsadresse) |
|
|
Landkode (beliggenhetsadresse) |
|
|
Land (beliggenhetsadresse) |
|
|
Underenhetens oppstartsdato |
|
|
Underenhetens dato for eierskifte |
|
|
Nedleggelsesdato for underenheten |
|
|
Lenke til egen ressurs |
|
|
Lenke til underenhetens overordnede enhet |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 2 - Hent underenhet (V2)
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/776655441' -i -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+json;charset=UTF-8'GET /enhetsregisteret/api/underenheter/776655441 HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+json;charset=UTF-8
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/vnd.brreg.enhetsregisteret.underenhet.v2+json;charset=UTF-8
Content-Length: 1292
{
"organisasjonsnummer" : "776655441",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"harRegistrertAntallAnsatte" : true,
"overordnetEnhet" : "112233445",
"beliggenhetsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"nedleggelsesdato" : "2018-10-20",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/776655441"
},
"overordnetEnhet" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}| Parameter | Description |
|---|---|
|
Enhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Underenhetens organisasjonsnummer |
|
|
Underenhetens navn |
|
|
Underenhetens organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Underenhetens hjemmeside |
|
|
Underenhetens postadresse |
|
|
Adresse (postadresse) |
|
|
Postnummer (postadresse) |
|
|
Poststed (postadresse) |
|
|
Kommunenummer (postadresse) |
|
|
Kommune (postadresse) |
|
|
Landkode (postadresse) |
|
|
Land (postadresse) |
|
|
Underenhetens registreringsdato i Enhetsregisteret |
|
|
Hvorvidt underenheten er registrert i MVA-registeret |
|
|
Underenheter som i utgangspunktet ikke er mva-pliktig, kan søke om frivillig registrering i Merverdiavgiftsregisteret. |
|
|
Næringskode 1 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 2 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Næringskode 3 |
|
|
Næringskoden |
|
|
Tekstlig beskrivelse av næringskoden |
|
|
Hjelpeenhetskode |
|
|
Hjelpeenhetskode |
|
|
Tekstlig beskrivelse av hjelpeenhetskode |
|
|
Antall ansatte |
|
|
Angir om enheten har registrert ansatte |
|
|
Underenhetens overordnede enhet |
|
|
Underenhetens beliggenhetsadresse |
|
|
Adresse (beliggenhetsadresse) |
|
|
Postnummer (beliggenhetsadresse) |
|
|
Poststed (beliggenhetsadresse) |
|
|
Kommunenummer (beliggenhetsadresse) |
|
|
Kommune (beliggenhetsadresse) |
|
|
Landkode (beliggenhetsadresse) |
|
|
Land (beliggenhetsadresse) |
|
|
Underenhetens oppstartsdato |
|
|
Underenhetens dato for eierskifte |
|
|
Nedleggelsesdato for underenheten |
|
|
Lenke til egen ressurs |
|
|
Lenke til underenhetens overordnede enhet |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 3 - Hent en slettet underenhet
Hvis en underenhet er slettet vil responsen få statuskode 200 OK. HTTP Responsen vil da også inneholde færre attributter, som vist i eksempelet under.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/987123456' -i -X GETGET /enhetsregisteret/api/underenheter/987123456 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 512
{
"organisasjonsnummer" : "987123456",
"navn" : "SLETTET UNDERENHET AS",
"organisasjonsform" : {
"kode" : "AAFY",
"beskrivelse" : "Virksomhet til ikke-næringsdrivende person",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AAFY"
}
}
},
"slettedato" : "2017-10-20",
"nedleggelsesdato" : "2017-10-5",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/987123456"
}
}
}| Parameter | Description |
|---|---|
|
Den slettede underenhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Organisasjonsnummer |
|
|
Organisasjonsform |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Navn |
|
|
Nedleggelsesdato for underenheten |
|
|
Dato under-/enheten ble slettet |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 4 - Hent en fjernet underenhet
En underenhet kan fjernes fra avgivelsen fra Enhetsregisteret for eksempel av juridiske årsaker. Hvis en underenhet er fjernet vil denne få statuskode 410 Gone. Dette bør også anses som en forespørsel om at eventuelle kopier/cacher også fjerner den aktuelle underenheten.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/900111222' -i -X GETGET /enhetsregisteret/api/underenheter/900111222 HTTP/1.1
Host: data.brreg.noHTTP/1.1 410 Gone
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 191
{
"organisasjonsnummer" : "900111222",
"slettedato" : "2022-08-06",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/900111222"
}
}
}| Parameter | Description |
|---|---|
|
Den slettede underenhetens organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
Organisasjonsnummer |
|
|
Dato under-/enheten ble fjernet |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Last ned underenheter
Eksempel 1 - Last ned alle underenheter i json-format (V1 - erstattes av V2)
Alle underenheter kan lastes ned i en fil komprimert med gzip. Formatet på denne filen er i forenklet json, og vil ikke inkludere lenker som i HAL formatet. Filen produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned' -X GET -J -OGET /enhetsregisteret/api/underenheter/lastned HTTP/1.1
Host: data.brreg.noEksempel 2 - Last ned alle underenheter i json-format (V2)
Alle underenheter kan lastes ned i en fil komprimert med gzip. Formatet på denne filen er i forenklet json, og vil ikke inkludere lenker som i HAL formatet. Filen produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned' -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+gzip;charset=UTF-8' -J -OGET /enhetsregisteret/api/underenheter/lastned HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+gzip;charset=UTF-8
Host: data.brreg.noEksempel 3 - Last ned alle underenheter i csv
Alle underenheter i csv format kan lastes ned til en fil komprimert med gzip. Filene produseres hver natt, cirka klokken 0500.
Vi anbefaler å bruke kolonnenavnene til å identifisere informasjonselementene, da det kan være at vi setter inn nye kolonner eller endrer rekkefølgen. Det er derfor best å unngå å bruke indeks/posisjon for kolonne når du leser csv-filen.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned/csv' -X GET -J -OGET /enhetsregisteret/api/underenheter/lastned/csv HTTP/1.1
Host: data.brreg.noEksempel 4 - Last ned alle underenheter i xlsx (V1 - erstattes av V2)
Alle underenheter kan lastes ned til fil på xlsx-format. Filene produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned/regneark' -X GET -J -OGET /enhetsregisteret/api/underenheter/lastned/regneark HTTP/1.1
Host: data.brreg.noEksempel 5 - Last ned alle underenheter i xlsx (V2)
Alle underenheter kan lastes ned til fil på xlsx-format. Filene produseres hver natt, cirka klokken 0500.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned/regneark' -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=UTF-8' -J -OGET /enhetsregisteret/api/underenheter/lastned/regneark HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.underenhet.v2+vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=UTF-8
Host: data.brreg.noEksempel 6 - Last ned søkeresultat
Resultatsettet av en spørring kan lastes ned i en fil komprimert med gzip. Formatet på denne filen er i forenklet json, og vil ikke inkludere lenker som i HAL formatet. Resultatfilen vil ha oppdaterte underenheter, men er begrenset til 10.000 underenheter. Hvis resultatsettet overstiger begrensningen, vil de siste underenhetene ekskluderes fra filen.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned?navn=Sesam' -X GET -J -OGET /enhetsregisteret/api/underenheter/lastned?navn=Sesam HTTP/1.1
Host: data.brreg.noEksempel 6 - Sjekk filstørrelsen uten å laste ned hele fila
Du kan sjekke filstørrelsen ved å benytte HTTP-verbet HEAD. Filstørrelsen kan du lese fra Content-Length headeren i responsen. I dette APIet støtter vi HEAD på alle URLer med filnedlasting.
$ curl 'https://data.brreg.no/enhetsregisteret/api/underenheter/lastned/regneark' --headHEAD /enhetsregisteret/api/underenheter/lastned/regneark HTTP/1.1
Host: data.brreg.noDetaljer
-
Se query-parametere for søk på underenheter.
-
Se sortering for enheter
-
Se feilmelding for enheter
-
Se navnesøk for enheter
Hente ut oppdaterte underenheter
Tjenesten tilbyr et søk på nylige oppdaterte underenheter i Enhetsregisteret. Søket kan spesifiseres med et søkeparameter angitt som et HTTP query-parameter, se beskrivelse. Maks antall parametre er 1024. Søkeresultatet er paginert med en standard sidestørrelse på 20 enheter.
Endringstyper
| Type | Beskrivelse |
|---|---|
Ukjent |
Ukjent type endring. Ofte fordi endringen har skjedd før endringstype ble innført. |
Ny |
Underenheten har blitt lagt til i Enhetsregisteret |
Endring |
Underenheten har blitt endret i Enhetsregisteret |
Sletting |
Underenheten har blitt slettet fra Enhetsregisteret |
Fjernet |
Underenheten har blitt fjernet fra Åpne Data. Eventuelle kopier skal også fjerne underenheten. |
Detaljer
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Vis bare oppdateringer fra og med dette tidsstempelet. Tidsstempelet indikerer når oppdateringen ble offentliggjort i dette APIet |
String |
Datetime (ISO-8601): yyyy-MM-dd’T’HH:mm:ss.SSS’Z' |
|
Vis bare oppdateringer fra og med oppdateringsid |
Integer |
Større eller lik 1 |
|
Vis bare oppdateringer på gitte organisasjonsnummer |
String |
Kommaseparert liste med organisasjonsnummer |
| Path | Type | Description |
|---|---|---|
|
|
En liste av oppdaterte underenheter |
|
|
Sekvensiell oppdateringsid for underenhet. |
|
|
Tidsstempel for når endringen på underenheten ble offentliggjort i dette APIet |
|
|
Underenhetens organisasjonsnummer. |
|
|
Type endring som ble gjennomført |
|
|
Lenke til underenhet |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til første side med resultater |
|
|
Lenke til forrige side med resultater |
|
|
Lenke til egen ressurs |
|
|
Lenke til neste side med resultater |
|
|
Lenke til siste side med resultater |
* Obligatorisk, feltet vil alltid være med i responsen.
Eksempel 1 - Hent alle oppdateringer
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter' -i -X GETGET /enhetsregisteret/api/oppdateringer/underenheter HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 888
{
"_embedded" : {
"oppdaterteUnderenheter" : [ {
"oppdateringsid" : 1,
"dato" : "2010-01-02T00:00:00.000Z",
"organisasjonsnummer" : "123456789",
"endringstype" : "Sletting",
"_links" : {
"underenhet" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/123456789"
}
}
}, {
"oppdateringsid" : 2,
"dato" : "2010-01-03T00:00:00.000Z",
"organisasjonsnummer" : "987654321",
"endringstype" : "Endring",
"_links" : {
"underenhet" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/987654321"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Eksempel 2 - Hent alle oppdateringer etter gitt dato
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter?dato=2010-01-03T00:00:00.000Z' -i -X GETGET /enhetsregisteret/api/oppdateringer/underenheter?dato=2010-01-03T00:00:00.000Z HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 615
{
"_embedded" : {
"oppdaterteUnderenheter" : [ {
"oppdateringsid" : 2,
"dato" : "2010-01-03T00:00:00.000Z",
"organisasjonsnummer" : "987654321",
"endringstype" : "Ukjent",
"_links" : {
"underenhet" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/987654321"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter?dato=2010-01-03T00:00:00.000Z"
}
},
"page" : {
"size" : 2,
"totalElements" : 1,
"totalPages" : 1,
"number" : 0
}
}Eksempel 3 - Hent alle oppdateringer etter gitt oppdateringsid
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter?oppdateringsid=2' -i -X GETGET /enhetsregisteret/api/oppdateringer/underenheter?oppdateringsid=2 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 602
{
"_embedded" : {
"oppdaterteUnderenheter" : [ {
"oppdateringsid" : 2,
"dato" : "2010-01-03T00:00:00.000Z",
"organisasjonsnummer" : "987654321",
"endringstype" : "Ukjent",
"_links" : {
"underenhet" : {
"href" : "http://localhost/enhetsregisteret/api/underenheter/987654321"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter?oppdateringsid=2"
}
},
"page" : {
"size" : 2,
"totalElements" : 1,
"totalPages" : 1,
"number" : 0
}
}Paginering
Det er mulig å filtrere og bla gjennom resultatsettet via page+size, dato og/eller updateid, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000 og det kan finnes flere elementer med samme dato. Updateid kan bare forekomme en gang, men disse er gjenbrukt på tvers av underenheter og enheter og kan ha gap på flere tusen id’er.
Vi anbefaler følgende bruk: Filtrer på dato for første gangs uthenting, slik at man unngår enheter tidligere enn eventuell siste kopi. Filtrer så på updateid for å hente neste sett av resultater. (Her kan man trygt bruke updateid+1). Page+size kan benyttes for mer presis navigering i en updateid- eller dato-spørring.
Organisasjonsform
Hent organisasjonsformer
Hent alle organisasjonsformer
$ curl 'https://data.brreg.no/enhetsregisteret/api/organisasjonsformer' -i -X GETGET /enhetsregisteret/api/organisasjonsformer HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1039
{
"_embedded" : {
"organisasjonsformer" : [ {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
}, {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
}, {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonforetak",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer"
},
"enheter" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/enheter"
},
"underenheter" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/underenheter"
}
}
}Paginering
Det er mulig å bla gjennom resultatsettet via page+size, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000. Ved oppslag på større enn 10 000 vil tjenesten returnere HTTP-status 400 med tilhørende feilmelding.
Hent organisasjonsformer for enheter
$ curl 'https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/enheter' -i -X GETGET /enhetsregisteret/api/organisasjonsformer/enheter HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 821
{
"_embedded" : {
"organisasjonsformer" : [ {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
}, {
"kode" : "ORGL",
"beskrivelse" : "Organisasjonsledd",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ORGL"
}
}
}, {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonforetak",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/enheter"
}
}
}Hent organisasjonsformer for underenheter
$ curl 'https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/underenheter' -i -X GETGET /enhetsregisteret/api/organisasjonsformer/underenheter HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 636
{
"_embedded" : {
"organisasjonsformer" : [ {
"kode" : "BEDR",
"beskrivelse" : "Bedrift",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/BEDR"
}
}
}, {
"kode" : "AAFY",
"beskrivelse" : "Virksomhet til ikke-næringsdrivende person",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AAFY"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/underenheter"
}
}
}Detaljer
Responsfeltene er felles for de tre øvrige endepunktene.
| Path | Type | Description |
|---|---|---|
|
|
En liste av organisasjonsformer som benyttes i Enhetsregisteret |
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
|
|
Lenke til egen ressurs |
|
|
Lenke til organisasjonsformer knyttet til juridiske enheter |
|
|
Lenke til organisasjonsformer knyttet til underenheter |
* Obligatorisk, feltet vil alltid være med i responsen.
Hent en organisasjonsform
$ curl 'https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/UTBG' -i -X GETGET /enhetsregisteret/api/organisasjonsformer/UTBG HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 223
{
"kode" : "UTBG",
"beskrivelse" : "Frivillig registrert utleiebygg",
"utgaatt" : "2017-07-17",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/UTBG"
}
}
}| Parameter | Description |
|---|---|
|
Organisasjonsform |
| Path | Type | Description |
|---|---|---|
|
|
Organisasjonsformen |
|
|
Tekstlig beskrivelse av organisasjonsformen |
|
|
Dato når organisasjonsformen evt. ble ugyldig |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Hvordan vedlikeholde en kopi av enhetsregisteret?
For å vedlikeholde en kopi av enhetsregisteret, er det følgende løp vi har lagt opp til:
-
Last ned totalbestand
-
Behandle totalbestand
-
Du kan for eksempel lagre eller indeksere et utvalg objekter i din egen database.
Totalbestand filene er store og får nok ikke plass i minnet på en gang. Vi anbefaler å benytte en strømmefunksjon for å lese fila litt etter litt.
-
-
Hent nye oppdateringer fortløpende
Du kan starte kopieringsjobben din fra en tidlig id eller et tidspunkt i god tid før totalbestanden er produsert. Da sikrer du at du får du med deg alle endringene!
-
Hvis det har kommet nye oppdateringer fra sist gang du oppdaterte, hent hele objektet på nytt:
Totalbestand roller
Hent totalbestand av roller for alle enheter
Se OpenAPI Spesifikasjon for informasjon om hvordan man kan hente totalbestanden av roller.
Rolleoppdateringer
Hent rolleoppdateringer
Dette APIet implementerer Cloud Events spesifikasjonen. Tabellen viser hendelsene i APIet:
| Hendelse | Beskrivelse |
|---|---|
no.brreg.enhetsregisteret.rolle.oppdatert |
Forekommer når en enhet får nye roller, endrer roller eller sletter roller. |
no.brreg.enhetsregisteret.rolle.enhet.oppdatert |
Forekommer når en enhet, som også er en rolle, endrer seg. Endringer kan være "navn", "organisasjonsform" eller "erSlettet". |
Detaljer
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Filtrer hendelser på organisasjonsnummeret til enheten |
string |
Kommaseparert liste med organisasjonsnummer |
|
Hent heldelser som har oppstått etter angitt tidspunkt. |
string |
Datetime (ISO-8601): yyyy-MM-dd’T’HH:mm:ss.SSS’Z' |
|
Hent hendelser som har oppstått etter angitt ID |
integer |
Større eller lik 0 |
|
Hent et spesifisert antall hendelser |
integer |
Større eller lik 1 og mindre eller lik 10000. Standardverdi er 100 |
| Path | Type | Description |
|---|---|---|
|
|
Versjon for CloudEvent spesifikasjon |
|
|
ID for hendelsen |
|
|
Kilden til hendelsen |
|
|
Type for hendelsen |
|
|
Dato for hendelsen |
|
|
Rolle data |
|
|
Unik id-nummer tilhørende hendelsen |
* Obligatorisk, feltet vil alltid være med i responsen.
Om size-parameteret
Hvis size query-parameter ikke er spesifisert, vil API-et returnere 100 hendelser. Da kan du telle antall hendelser i JSON-responsen og vurdere om du må gjøre flere forespørsler.
Hvis antallet hendelser i JSON-responsen tilsvarer det du spesifiserte i size query-parameteret (som default er 100), kan du anta at du ikke har hentet alle hendelsene.
Hvis antallet hendelser i responsen er lavere enn antallet som du spesifiserte i size query-parameteret, kan du anta at du har hentet alle hendelsene til nå. Da kan du vente litt og sjekke senere om det har kommet flere hendelser.
Eksempel 1 - Hent alle rolleoppdateringer
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/roller' -i -X GET \
-H 'Accept: application/cloudevents-batch+json'GET /enhetsregisteret/api/oppdateringer/roller HTTP/1.1
Accept: application/cloudevents-batch+json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/cloudevents-batch+json;charset=UTF-8
Content-Length: 1122
[ {
"specversion" : "1.0",
"id" : "1",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/974760673/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2021-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "974760673"
}
}, {
"specversion" : "1.0",
"id" : "2",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/974760674/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2022-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "974760674"
}
}, {
"specversion" : "1.0",
"id" : "3",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017902/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2023-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017902"
}
}, {
"specversion" : "1.0",
"id" : "4",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017903/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2024-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017903"
}
} ]Eksempel 2 - Hent alle rolleoppdateringer etter gitt id
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/roller?afterId=1' -i -X GET \
-H 'Accept: application/cloudevents-batch+json'GET /enhetsregisteret/api/oppdateringer/roller?afterId=1 HTTP/1.1
Accept: application/cloudevents-batch+json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/cloudevents-batch+json;charset=UTF-8
Content-Length: 842
[ {
"specversion" : "1.0",
"id" : "2",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/974760674/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2022-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "974760674"
}
}, {
"specversion" : "1.0",
"id" : "3",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017902/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2023-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017902"
}
}, {
"specversion" : "1.0",
"id" : "4",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017903/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2024-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017903"
}
} ]Eksempel 3 - Hent alle rolleoppdateringer etter gitt tidspunkt
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/roller?afterTime=2022-09-21T07:16:11.120Z' -i -X GET \
-H 'Accept: application/cloudevents-batch+json'GET /enhetsregisteret/api/oppdateringer/roller?afterTime=2022-09-21T07:16:11.120Z HTTP/1.1
Accept: application/cloudevents-batch+json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/cloudevents-batch+json;charset=UTF-8
Content-Length: 562
[ {
"specversion" : "1.0",
"id" : "3",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017902/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2023-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017902"
}
}, {
"specversion" : "1.0",
"id" : "4",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017903/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2024-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017903"
}
} ]Eksempel 4 - Hent alle rolleoppdateringer med spesifisert organisasjonsnummer
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/roller?organisasjonsnummer=810017903' -i -X GET \
-H 'Accept: application/cloudevents-batch+json'GET /enhetsregisteret/api/oppdateringer/roller?organisasjonsnummer=810017903 HTTP/1.1
Accept: application/cloudevents-batch+json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/cloudevents-batch+json;charset=UTF-8
Content-Length: 282
[ {
"specversion" : "1.0",
"id" : "4",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/810017903/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2024-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "810017903"
}
} ]Eksempel 5 - Hent rolleoppdateringer med en spesifisert størrelse
$ curl 'https://data.brreg.no/enhetsregisteret/api/oppdateringer/roller?size=2' -i -X GET \
-H 'Accept: application/cloudevents-batch+json'GET /enhetsregisteret/api/oppdateringer/roller?size=2 HTTP/1.1
Accept: application/cloudevents-batch+json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/cloudevents-batch+json;charset=UTF-8
Content-Length: 562
[ {
"specversion" : "1.0",
"id" : "1",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/974760673/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2021-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "974760673"
}
}, {
"specversion" : "1.0",
"id" : "2",
"source" : "https://data.brreg.no/enhetsregisteret/api/enheter/974760674/roller",
"type" : "no.brreg.enhetsregisteret.rolle.oppdatert",
"time" : "2022-00-00T00:00:00.000Z",
"data" : {
"organisasjonsnummer" : "974760674"
}
} ]|
Se flere detaljer i OpenAPI Spesifikasjon for informasjon om hvordan man kan hente rolleoppdateringer. |
Rolletype
Se OpenAPI Spesifikasjon for mer informasjon om hvordan dette endepunktet kan brukes.
|
Eksemplene for rolletype og rollegruppetype er statiske og viser ikke alle nåværende typer. For å få alle typene må du gjøre spørringen fra eksemplet selv. |
Hent rolletyper
Eksempel 1 - Hent alle rolletyper
$ curl 'https://data.brreg.no/enhetsregisteret/api/roller/rolletyper' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/roller/rolletyper HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1316
{
"_embedded" : {
"rolletyper" : [ {
"kode" : "ADOS",
"beskrivelse" : "Administrativ enhet - offentlig sektor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/ADOS"
}
}
}, {
"kode" : "BEST",
"beskrivelse" : "Bestyrende reder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/BEST"
}
}
}, {
"kode" : "BOBE",
"beskrivelse" : "Bostyrer",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/BOBE"
}
}
}, {
"kode" : "DAGL",
"beskrivelse" : "Daglig leder/administrerende direktør",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DAGL"
}
}
}, {
"kode" : "DTPR",
"beskrivelse" : "Deltaker med proratarisk ansvar (delt ansvar)",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/DTPR"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper"
}
}
}| Path | Type | Description |
|---|---|---|
|
|
HAL embedded objekt |
|
|
Liste med rolletyper |
|
|
Rolletype, og beskrivelse av typen |
|
|
Kode for rolletype |
|
|
Beskrivelse av rolletypen |
|
|
Lenke for rolletype |
|
|
|
|
|
Self-link for rolletype |
|
|
Lenke for rolletype |
|
|
|
|
|
Self-link for rolletype |
|
|
Lenke for rolletyper |
|
|
|
|
|
Self-link for rolletyper |
* Obligatorisk, feltet vil alltid være med i responsen.
Hent en rolletype
Eksempel 1 - Oppslag på rolletype ADOS
$ curl 'https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/ADOS' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/roller/rolletyper/ADOS HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 205
{
"kode" : "ADOS",
"beskrivelse" : "Administrativ enhet - offentlig sektor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rolletyper/ADOS"
}
}
}| Parameter | Description |
|---|---|
|
Koden til rolletypen |
| Path | Type | Description |
|---|---|---|
|
|
Kode for rolletype |
|
|
Beskrivelse av rolletypen |
|
|
Lenke for rolletype |
|
|
|
|
|
Self-link for rolletype |
* Obligatorisk, feltet vil alltid være med i responsen.
Rollegruppetype
Se OpenAPI Spesifikasjon for mer informasjon om hvordan dette endepunktet kan brukes.
|
Eksemplene for rolletype og rollegruppetype er statiske og viser ikke alle nåværende typer. For å få alle typene må du gjøre spørringen fra eksemplet selv. |
Hent rollegruppetyper
Eksempel 1 - Hent alle rollegruppetyper
$ curl 'https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/roller/rollegruppetyper HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1322
{
"_embedded" : {
"rollegruppetyper" : [ {
"kode" : "ADOS",
"beskrivelse" : "Administrativ enhet - offentlig sektor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/ADOS"
}
}
}, {
"kode" : "BEST",
"beskrivelse" : "Bestyrende reder",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/BEST"
}
}
}, {
"kode" : "BOBE",
"beskrivelse" : "Bostyrer",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/BOBE"
}
}
}, {
"kode" : "DAGL",
"beskrivelse" : "Daglig leder/administrerende direktør",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/DAGL"
}
}
}, {
"kode" : "DELT",
"beskrivelse" : "Deltakere",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/DELT"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper"
}
}
}| Path | Type | Description |
|---|---|---|
|
|
HAL embedded objekt |
|
|
Liste med rollegruppetyper |
|
|
Rollegruppetype, og beskrivelse av typen |
|
|
Kode for rollegruppetype |
|
|
Beskrivelse av rollegruppetypen |
|
|
Lenke for rollegruppetype |
|
|
|
|
|
Self-link for rollegruppetype |
|
|
Lenke for rollegruppetype |
|
|
|
|
|
Self-link for rollegruppetype |
|
|
Lenke for rolletyper |
|
|
|
|
|
Self-link for rollegruppetyper |
* Obligatorisk, feltet vil alltid være med i responsen.
Hent en rollegruppetype
Eksempel 1 - Oppslag på rollegruppetype ADOS
$ curl 'https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/ADOS' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/roller/rollegruppetyper/ADOS HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 211
{
"kode" : "ADOS",
"beskrivelse" : "Administrativ enhet - offentlig sektor",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/rollegruppetyper/ADOS"
}
}
}| Parameter | Description |
|---|---|
|
Koden til rollegruppetypen |
| Path | Type | Description |
|---|---|---|
|
|
Kode for rollegruppetype |
|
|
Beskrivelse av rollegruppetypen |
|
|
Lenke for rollegruppetype |
|
|
|
|
|
Self-link for rollegruppetype |
* Obligatorisk, feltet vil alltid være med i responsen.
Representant
Se OpenAPI Spesifikasjon for mer informasjon om hvordan dette endepunktet kan brukes.
|
Eksemplene for rolletype og rollegruppetype er statiske og viser ikke alle nåværende typer. For å få alle typene må du gjøre spørringen fra eksemplet selv. |
Hent representanter
Eksempel 1 - Hent alle representanter
$ curl 'https://data.brreg.no/enhetsregisteret/api/roller/representanter' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/roller/representanter HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 1114
{
"_embedded" : {
"representanter" : [ {
"kode" : "A-AK",
"beskrivelse" : "Representant for A-aksjonærene",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter/A-AK"
}
}
}, {
"kode" : "AREP",
"beskrivelse" : "Representant for de ansatte",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter/AREP"
}
}
}, {
"kode" : "B-AK",
"beskrivelse" : "Representant for B-aksjonærene",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter/B-AK"
}
}
}, {
"kode" : "C-AK",
"beskrivelse" : "Representant for C-aksjonærene",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter/C-AK"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter"
}
}
}| Path | Type | Description |
|---|---|---|
|
|
HAL embedded objekt |
|
|
Liste med representanter |
|
|
Kode og beskrivelse av hvem rollen representerer (ikke innehaver) |
|
|
Kode |
|
|
Beskrivelse tilknyttet koden |
|
|
Lenker for representant |
|
|
|
|
|
Self-link for representant |
|
|
Lenke for representant |
|
|
|
|
|
Self-link for representant |
|
|
Lenke for representanter |
|
|
|
|
|
Self-link for representanter |
* Obligatorisk, feltet vil alltid være med i responsen.
Hent en representant
Eksempel 1 - Oppslag på representant AREP
$ curl 'https://data.brreg.no/enhetsregisteret/api/roller/representanter/AREP' -i -X GET \
-H 'Accept: application/json'GET /enhetsregisteret/api/roller/representanter/AREP HTTP/1.1
Accept: application/json
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 198
{
"kode" : "AREP",
"beskrivelse" : "Representant for de ansatte",
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/roller/representanter/AREP"
}
}
}| Parameter | Description |
|---|---|
|
Koden til representanten |
| Path | Type | Description |
|---|---|---|
|
|
Kode |
|
|
Beskrivelse tilknyttet koden |
|
|
Lenker for representant |
|
|
|
|
|
Self-link for representant |
* Obligatorisk, feltet vil alltid være med i responsen.
Kommuner og geografisk områdeinndeling i Enhetsregisteret
Hent kommuner og geografisk områdeinndeling
Hent alle kommuner
$ curl 'https://data.brreg.no/enhetsregisteret/api/kommuner' -i -X GETGET /enhetsregisteret/api/kommuner HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 631
{
"_embedded" : {
"kommuner" : [ {
"nummer" : "0103",
"navn" : "OSLO",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/kommuner/0103"
}
}
}, {
"nummer" : "1813",
"navn" : "BRØNNØY",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/kommuner/1813"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/kommuner"
}
},
"page" : {
"size" : 20,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}Paginering
Det er mulig å bla gjennom resultatsettet via page+size, men med visse begrensninger. (Page+1)*size kan ikke overskride 10 000. Ved oppslag på større enn 10 000 vil tjenesten returnere HTTP-status 400 med tilhørende feilmelding.
Detaljer
Responsfeltene er felles for endepunktene.
| Path | Type | Description |
|---|---|---|
|
|
En liste av kommuner og spesialområder som benyttes i Enhetsregisteret |
|
|
Kommunenummer |
|
|
Navn på kommunen |
|
|
Lenke til egen ressurs |
|
|
Sidestørrelse på resultatet |
|
|
Totalt antall elementer i resultatet |
|
|
Totalt antall sider i resultatet |
|
|
Nummer på gjeldende side |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Hent en kommune
$ curl 'https://data.brreg.no/enhetsregisteret/api/kommuner/1813' -i -X GETGET /enhetsregisteret/api/kommuner/1813 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 161
{
"nummer" : "1813",
"navn" : "BRØNNØYSUND",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/kommuner/1813"
}
}
}| Parameter | Description |
|---|---|
|
Kommunenummer |
| Path | Type | Description |
|---|---|---|
|
|
Kommunenummer |
|
|
Navn på kommunen |
|
|
Lenke til egen ressurs |
* Obligatorisk, feltet vil alltid være med i responsen.
Matrikkelenhet
Hent matrikkelenhet
Hent matrikkelenhet med matrikkelenhetid
$ curl 'https://data.brreg.no/enhetsregisteret/api/matrikkelenhet?matrikkelenhetid=2020202' -i -X GETGET /enhetsregisteret/api/matrikkelenhet?matrikkelenhetid=2020202 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 178
[ {
"orgnr" : "912345678",
"kommnr" : "1234",
"gaardsnr" : "64564",
"bruksnr" : "432123",
"festenr" : "5121",
"matrikkelenhetid" : "2020202",
"rekkefolge" : "1"
} ]Hent matrikkelenheter med matrikkelnummer
Ved søk på matrikkelnummer må kommunenummer, gårdsnummer, bruksnummer og eventuelt festenummer inngå i spørringen.
$ curl 'https://data.brreg.no/enhetsregisteret/api/matrikkelenhet?matrikkelnummer=1234-77665/55677/5434' -i -X GETGET /enhetsregisteret/api/matrikkelenhet?matrikkelnummer=1234-77665/55677/5434 HTTP/1.1
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
Content-Length: 177
[ {
"orgnr" : "987654321",
"kommnr" : "1234",
"gaardsnr" : "77665",
"bruksnr" : "55677",
"festenr" : "5434",
"matrikkelenhetid" : "1010101",
"rekkefolge" : "1"
} ]Detaljer
| Parameter | Description | Datatype | Format |
|---|---|---|---|
|
Unikt nummer som identifiserer eiendommen i eiendomsregisteret (matrikkelen) og i grunnboken. Matrikkelnummeret består av et kommunenummer, gårds- og bruksnummer, og noen ganger også av et festenummer. |
String |
Kommunenr-Gårdsnr/Bruksnr/Festenr |
|
Informasjonsløs identifikator for en matrikkelenhet |
String |
Tall |
| Path | Type | Description |
|---|---|---|
|
|
Matrikkelenhetens organisasjonsnummer |
|
|
Matrikkelenhetens kommunenummer |
|
|
Matrikkelenhetens gårdsnummer |
|
|
Matrikkelenhetens bruksnummer |
|
|
Matrikkelenhetens festenummer |
|
|
Informasjonsløs identifikator for en matrikkelenhet |
|
|
Matrikkelenhetens rekkefølge på organisasjonsnummer |
* Obligatorisk, feltet vil alltid være med i responsen.
Versjonering
Versjoner i bruk
| API | Header |
|---|---|
/ |
application/vnd.brreg.enhetsregisteret.v1+json |
/enheter |
application/vnd.brreg.enhetsregisteret.enhet.v1+json |
/enheter/lastned |
application/vnd.brreg.enhetsregisteret.enhet.v1+gzip;charset=UTF-8 |
/enheter/lastned/regneark |
application/vnd.brreg.enhetsregisteret.enhet+vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=UTF-8 |
/enheter/lastned/csv |
application/vnd.brreg.enhetsregisteret.enhet.v2+gzip;charset=UTF-8 |
/enheter/{organisasjonsnummer}/roller |
application/vnd.brreg.enhetsregisteret.rolle.v1+json |
/underenheter |
application/vnd.brreg.enhetsregisteret.underenhet.v1+json |
/underenheter/lastned |
application/vnd.brreg.enhetsregisteret.underenhet.v1+gzip;charset=UTF-8 |
/underenheter/lastned/regneark |
application/vnd.brreg.enhetsregisteret.underenhet+vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=UTF-8 |
/underenheter/lastned/csv |
application/vnd.brreg.enhetsregisteret.underenhet.v2+gzip;charset=UTF-8 |
/oppdateringer/enheter |
application/vnd.brreg.enhetsregisteret.oppdatering.enhet.v1+json |
/oppdateringer/underenheter |
application/vnd.brreg.enhetsregisteret.oppdatering.underenhet.v1+json |
/oppdateringer/roller |
application/cloudevents-batch+json |
/organisasjonsformer |
application/vnd.brreg.enhetsregisteret.organisasjonsform.v1+json |
/kommuner |
application/vnd.brreg.enhetsregisteret.kommune.v1+json |
/roller/rolletyper |
application/vnd.brreg.enhetsregisteret.rolletype.v1+json |
/roller/rollegruppetyper |
application/vnd.brreg.enhetsregisteret.rollegruppetype.v1+json |
/roller/representanter |
application/vnd.brreg.enhetsregisteret.representant.v1+json |
Hvorfor har vi versjon 2?
Vi har innnført endringer på noen av endepunktene som ikke er bakoverkompatible, og vi har derfor sett oss nødt til å versjonere dem.
Hva må jeg gjøre?
Fra 01.03.2024 tar versjon 2 over som ny standard. Er du ikke klar til å ta i bruk versjon 2, må du eksplisitt be om versjon 1. Hvis du ikke foretar deg noe, risikerer du at api-kallet feiler 01.03.2024. Hvordan velger jeg versjon?.
01.09.2024 fjerner vi versjon 1, innen da må du ha tatt høyde for endringene. Se endringne i Endringslogg.
Strategi
Vi vil forsøke, så langt det lar seg gjøre å ikke bryte bakoverkompatibiliteten med våre brukere.Likevel kan det være nødvendig i enkelte situasjoner, av for eksempel juridiske årsaker eller vedlikehold å gjøre endringer som medfører et slikt brudd.
Vi vil i dette tilfellet versjonere tjenesten slik at nyeste versjon vil være tilgjengelig sammen med forrige versjon. Dersom man ikke benytter versjonering i accept header, vil man få siste versjon.
Eldre versjon vil anses som utdatert/deprecated, og vil på sikt bli tatt bort. Ved behov for denne typen endringer vil vi forsøke å gi bruker god tid, og varsle om endringen i forkant. Se punkt om varsling.
Når innføres det en ny versjon?
Vi vil innføre en ny versjon når vi introduserer en endring som påvirker bakoverkompatibiliteten. Mindre endringer og patcher vil ikke medføre versjonsendring i header.
Eksempel på endring som medfører versjonering:
-
Fjerne eller endre navn på et attributt i HTTP-responsen.
-
Fjerne eller endre navn på et REST endepunkt.
Når fjernes en versjon?
Vi vil legge ut varsel/driftsmeldinger i god tid på driftsmeldinger. I tillegg kan du abonnere på en RSS-feed .
Hvordan velger jeg versjon?
Du kan velge versjon ved å spesifisere HTTP Accept-headeren. Bruk headeren spesifisert i denne tabellen.
|
Om du ikke spesifiserer Accept-header, vil du automatisk få den seneste versjonen etter 01.03.2024. |
Eksempel 1 - Rot
$ curl 'https://data.brreg.no/enhetsregisteret/api/' -i -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.v1+json;charset=UTF-8'GET /enhetsregisteret/api/ HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.v1+json;charset=UTF-8
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/vnd.brreg.enhetsregisteret.v1+json;charset=UTF-8
Content-Length: 763
{
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api"
},
"enheter" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter"
},
"underenheter" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/underenheter"
},
"organisasjonsformer" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer"
},
"oppdateringer/enheter" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/enheter"
},
"oppdateringer/underenheter" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/oppdateringer/underenheter"
},
"kommuner" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/kommuner"
}
}
}Eksempel 2 - Enheter
$ curl 'https://data.brreg.no/enhetsregisteret/api/enheter' -i -X GET \
-H 'Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8'GET /enhetsregisteret/api/enheter HTTP/1.1
Accept: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8
Host: data.brreg.noHTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/vnd.brreg.enhetsregisteret.enhet.v2+json;charset=UTF-8
Content-Length: 3510
{
"_embedded" : {
"enheter" : [ {
"organisasjonsnummer" : "112233445",
"navn" : "SESAM STASJON",
"organisasjonsform" : {
"kode" : "AS",
"beskrivelse" : "Aksjeselskap",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/AS"
}
}
},
"postadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0122",
"poststed" : "OSLO",
"adresse" : [ "c/o reder K. Rusing", "Postboks 1752 Vika", "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "52.292",
"beskrivelse" : "Skipsmegling"
},
"antallAnsatte" : 50,
"harRegistrertAntallAnsatte" : true,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "0101",
"poststed" : "OSLO",
"adresse" : [ "Tyvholmen 1", null, null, "" ],
"kommune" : "OSLO",
"kommunenummer" : "0301"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : true,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"konkursdato" : "",
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Bokmål",
"vedtektsdato" : "2017-10-21",
"vedtektsfestetFormaal" : [ "" ],
"aktivitet" : [ ],
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/112233445"
}
}
}, {
"organisasjonsnummer" : "443322119",
"navn" : "TRYLLEBUTIKKEN SESAM",
"organisasjonsform" : {
"kode" : "ENK",
"beskrivelse" : "Enkeltpersonforetak",
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/organisasjonsformer/ENK"
}
}
},
"registreringsdatoEnhetsregisteret" : "2017-10-20",
"registrertIMvaregisteret" : true,
"naeringskode1" : {
"kode" : "90.012",
"beskrivelse" : "Utøvende kunstnere og underholdsningsvirksomhet innen scenekunst"
},
"harRegistrertAntallAnsatte" : false,
"forretningsadresse" : {
"land" : "Norge",
"landkode" : "NO",
"postnummer" : "2120",
"poststed" : "NORD-ODAL",
"adresse" : [ "Sagstua", null, null ],
"kommune" : "NORD-ODAL",
"kommunenummer" : "0418"
},
"stiftelsesdato" : "2017-10-20",
"registrertIForetaksregisteret" : false,
"registrertIStiftelsesregisteret" : false,
"registrertIFrivillighetsregisteret" : false,
"konkurs" : false,
"konkursdato" : "",
"underAvvikling" : false,
"underTvangsavviklingEllerTvangsopplosning" : false,
"maalform" : "Nynorsk",
"vedtektsdato" : "2017-10-21",
"vedtektsfestetFormaal" : [ "" ],
"aktivitet" : [ ],
"_links" : {
"self" : {
"href" : "http://localhost/enhetsregisteret/api/enheter/443322119"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://data.brreg.no/enhetsregisteret/api/enheter"
}
},
"page" : {
"size" : 2,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}