Gå til innhold
NOR

Forvaltningsdatabasen

API-dokumentasjon for Forvaltningsdatabasen

REST API for programmatisk tilgang til data om enheter, ansatte og organisatoriske endringer i norsk statsforvaltning.

API-server og dokumentasjon

Swagger UI viser som standard gruppen «Ekstern» med alle endepunktene som er relevante for eksterne brukere. Gruppen «Alle (intern)» i nedtrekksmenyen øverst til høyre viser i tillegg hjelpeendepunkter som brukes av nettsiden.

Autentisering

Bulk-uttrekkene (markert med 🔒) krever et Bearer-token fra AWS Cognito. Kontakt Forvaltningsdatabasen for å få clientId og clientSecret. Oppslag på enkeltenheter er åpne og krever ikke token.

Steg 1 – Hent token

Gjør følgende HTTP-kall for å hente et access token (gyldig i 1 time):

curl -X POST https://eu-north-1w9zgiivaq.auth.eu-north-1.amazoncognito.com/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>"

Svaret inneholder access_token:

{
  "access_token": "eyJraWQiOiJH...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Steg 2 – Bruk token i API-kall

Legg tokenet i Authorization-headeren:

curl --compressed -H "Authorization: Bearer eyJraWQiOiJH..." \
  "https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/eval/enheteraar?y=2023"

Når tokenet utløper, henter du et nytt med samme kall som i steg 1. I Swagger UI: klikk Authorize øverst på siden og lim inn kun token-strengen (uten "Bearer "-prefikset).

API-endepunkter

Enheter – bulk-uttrekk 🔒

Maskinlesbare uttrekk beregnet for forskere og analytikere som vil laste ned hele datasettet. Alle endepunkter her krever autentisering (Bearer token fra AWS Cognito).

Endepunkter for maskinlesbart uttrekk av alle enheter – krever Bearer token
MetodeStiBeskrivelse
GET/api/v1/enheter/eval/enheterkomplett 🔒Alle enheter med komplett endringshistorikk
GET/api/v1/enheter/eval/endringsrader 🔒Alle endringsrader – rådata fra databasen med endringskodebeskrivelse og relasjoner
GET/api/v1/enheter/eval/enheteraar?y={år} 🔒Alle enheter aktive i et gitt år med attributter ved årets slutt

Enheter

Søk og detaljoppslag på enkeltenheter, og kodelister for å tolke kodene i uttrekkene. Disse endepunktene er åpne og krever ikke autentisering.

Endepunkter for enheter
MetodeStiBeskrivelse
GET/api/v1/enheter?q={søketekst}Søk etter enheter på navn eller kortnavn (historisk og nåværende)
GET/api/v1/enheter/{idnum}Detaljert informasjon om én enhet
GET/api/v1/enheter/{idnum}/endringshistorieFull endringshistorikk for én enhet, inkl. Stortingssaker og relasjoner
GET/api/v1/enheter/koderKodelister for tilknytningsform, nivå og grunnenhet

Data fra nettsiden

De øvrige endepunktene gir de samme dataene som vises på forvaltningsdatabasen.sikt.no: enheter, statistikk, ansatte, utvalg og litteratur. Du kan også hente disse dataene via API-et i stedet for å lese dem av nettsiden, f.eks. for å bruke dem i egne analyser. De er åpne og krever ikke autentisering. Se Swagger UI for fullstendig liste med parametere og svarformat.

Oversikt over andre åpne endepunkter
OmrådeEksempler på stierInnhold
Mer per enhet/api/v1/enheter/{idnum}/hierarki
/api/v1/enheter/{idnum}/relasjon
/api/v1/enheter/{idnum}/ansatte		Hierarki, relasjoner, ansatte, oppgaver, lover, tildelingsbrev, årsmeldinger, instrukser, utvalg m.m.
Statistikk/api/v1/statistikk/antall-enheter-endring
/api/v1/enheter/eval/endringerperaar
/api/v1/enheter/cofog		Antall enheter og endringer per år, tilknytningsform, grunnenhet, COFOG, fylke og kommune
Ansatte/api/v1/ansatte/land
/api/v1/ansatte/fylker
/api/v1/ansatte/etater		Ansattestatistikk nasjonalt og per fylke, kommune, departementsområde og etat
Tabell og oppgaver/api/v1/tabell
/api/v1/oppgaver		Uttak av enhetsdata med valgte variabler, og enheter per oppgavekode
Utvalg/api/v1/utvalg/sok
/api/v1/utvalg/{unr}		Utvalgsarkivet – statlige utvalg, styrer og råd med medlemmer
Litteratur/api/v1/litteratur/sok
/api/v1/enheter/{idnum}/litteratur		Publikasjoner knyttet til forvaltningsenheter
Enhetsregisteret og KRD/api/v1/enheter/enhetsregisteret/sok
/api/v1/krd		Brønnøysund-data for statlige virksomheter, og KRD-utflyttinger

Eksempler

Bulk-uttrekkene er flere MB store. Bruk --compressed og -o for å laste dem ned til fil – det går raskere enn å åpne dem i Swagger UI.

Komplett endringshistorikk for alle enheter 🔒

Hent alle enheter med full endringshistorikk for hele databasens levetid (krever Bearer token):

curl --compressed -H "Authorization: Bearer eyJraWQiOiJH..." \
  https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/eval/enheterkomplett \
  -o enheterkomplett.json

Eksempelsvar (forkortet):

[
  {
    "idnum": 1234,
    "endringer": [
      {
        "endringskode": 101,
        "dato": "2008-01-01",
        "langtNavn": "Direktoratet for forvaltning og IKT",
        "kortNavn": "Difi",
        "tilknytningsformKode": 33,
        "tilknytningsform": "Ordinære forvaltningsorgan",
        "grunntype": 1,
        "grunntypeNavn": "Enkeltstående nasjonalt organ",
        "overordnetIdnum": 610,
        "overordnetLangtNavn": "Kommunal- og moderniseringsdepartementet",
        "overordnetKortNavn": "KMD",
        "relasjoner": null,
        "relasjonerAndre": null
      },
      {
        "endringskode": 306,
        "dato": "2020-01-01",
        "relasjoner": [9999],
        "relasjonerAndre": null
      }
    ]
  }
]

Rådata – alle endringsrader 🔒

Hent alle rader direkte fra databasen med endringskodebeskrivelse og relasjoner (krever Bearer token). Feltet idnumEndringRef tolkes i henhold til endringskoden – f.eks. ved kode 304 (Nedlagt via splitting) viser det hvilke enheter den nedlagte enheten ble splittet i.

curl --compressed -H "Authorization: Bearer eyJraWQiOiJH..." \
  https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/eval/endringsrader \
  -o endringsrader.json

Eksempelsvar (forkortet):

[
  {
    "id": 1,
    "idnum": 100,
    "tekstEntall": "Ny enhet",
    "endringskode": 101,
    "tidspunkt": "1939-10-01",
    "kortNavn": "SMK",
    "langtNavn": "Statsministerens kontor",
    "engLangtNavn": "Office of the Prime Minister",
    "tilknytningsform": 10,
    "overordnetIdnum": -500
  },
  {
    "id": 4035,
    "idnum": 3500,
    "tekstEntall": "Nedlagt via splitting",
    "endringskode": 304,
    "tidspunkt": "2020-01-01",
    "idnumEndringRef": [4035, 4036],
    "kortNavn": "Difi",
    "langtNavn": "Direktoratet for forvaltning og IKT",
    "overordnetIdnum": 610
  }
]

Alle enheter aktive i et gitt år 🔒

Hent alle enheter som var aktive i løpet av 2023 (krever Bearer token):

curl --compressed -H "Authorization: Bearer eyJraWQiOiJH..." \
  "https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/eval/enheteraar?y=2023"

Eksempelsvar:

[
  {
    "idnum": 100,
    "langtNavn": "Statsministerens kontor",
    "kortNavn": "SMK",
    "tilknytningsformKode": 10,
    "tilknytningsform": "Departement",
    "grunntype": 0,
    "grunntypeNavn": "Departement",
    "overordnetIdnum": null,
    "overordnetLangtNavn": null,
    "overordnetKortNavn": null
  },
  {
    "idnum": 5678,
    "langtNavn": "Direktoratet for høyere utdanning og kompetanse",
    "kortNavn": "HK-dir",
    "tilknytningsformKode": 33,
    "tilknytningsform": "Ordinære forvaltningsorgan",
    "grunntype": 1,
    "grunntypeNavn": "Enkeltstående nasjonalt organ",
    "overordnetIdnum": 605,
    "overordnetLangtNavn": "Kunnskapsdepartementet",
    "overordnetKortNavn": "KD"
  }
]

Søk etter enheter

Søk etter enheter med navn eller kortnavn som inneholder "difi":

curl "https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter?q=difi"

Eksempelsvar (forkortet):

[
  {
    "id": 40601,
    "name": "Digitaliseringsdirektoratet",
    "nameEnglish": "Norwegian Digitalisation Agency",
    "shortName": "Digitaliseringsdirektoratet",
    "established": "2008-01-01",
    "active": true
  }
]

Hent enhet på ID

curl https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/40601

Eksempelsvar (forkortet):

{
  "id": 40601,
  "name": "Digitaliseringsdirektoratet",
  "nameEnglish": "Norwegian Digitalisation Agency",
  "shortName": "Digitaliseringsdirektoratet",
  "affiliationType": 20,
  "affiliationTypeName": "Direktorater (ordinært forvaltningsorgan)",
  "grunnenhet": 0,
  "typeName": "Nasjonal organisasjon",
  "cofog": "01",
  "cofogName": "Alminnelig offentlig tjenesteyting",
  "parentId": 57905,
  "parentName": "Digitaliserings- og forvaltningsdepartementet",
  "municipalityNumber": 301,
  "municipalityName": "Oslo",
  "established": "2008-01-01",
  "establishmentType": "Ny via omorganisering",
  "nameAtFounding": "Direktoratet for forvaltning og IKT",
  "creationRelations": [
    { "id": 29600, "name": "Statskonsult AS" },
    { "id": 40600, "name": "Norge.no" }
  ],
  "active": true,
  "organizationNumbers": [991825827]
}

Endringshistorikk for én enhet

curl https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/40601/endringshistorie

Eksempelsvar (forkortet):

[
  {
    "id": 21456,
    "endringskode": 221,
    "endringskodeNavn": "Horisontal flytting",
    "kortDokumentasjon": "Enheten har endret overordnet.",
    "tidspunkt": "2024-01-01",
    "bekreftetDato": true,
    "overordnetIdnum": 57905,
    "overordnetNavn": "Digitaliserings- og forvaltningsdepartementet",
    "dok": "Virksomheten overføres fra Kommunal- og distriktsdepartementet (KDD) til Digitaliserings- og forvaltningsdepartementet (DFD) ...",
    "stortingetsaksnummer": [],
    "relasjoner": []
  }
]

Kodelister

Tekster for kodene for tilknytningsform, nivå og grunnenhet som brukes i uttrekkene:

curl https://forvaltningsdatabasen-api.sikt.no/api/v1/enheter/koder

Eksempelsvar (forkortet):

{
  "tilknytningsformer": [
    { "kode": 20, "tekst": "Direktorater (ordinært forvaltningsorgan)", "engTekst": "Central agency/directorate" }
  ],
  "nivaaer": [
    { "kode": 0, "tekstEntall": "Høyeste nivå", "engTekstEntall": "Highest level" }
  ],
  "grunnenheter": [
    { "kode": 0, "tekst": "Nasjonal organisasjon", "engTekst": "National single organization (without subordinated units)" }
  ],
  "fraAar": 1753,
  "tilAar": 2026
}

Hei! Vi vil gjerne vite til hvilket formål du bruker nettsiden: