Hopp til hovedinnhold
DFØ Kudos - Kunnskapsdokumenter i offentlig sektor DFØ Kudos logo

Start / Åpne data

Åpne data API v2.0

Dokumentene som publiseres på Kudos er offentlige, og tilbys som åpne data gjennom et REST API. Hent dokumenter og aktører direkte fra Kudos — Norges offentlige dokumentarkiv, driftet av Direktoratet for forvaltning og økonomistyring (DFØ).

Muligheter

  • Hente dokumenter — Søk og filtrer offentlige dokumenter basert bl.a. på publiseringsdato, dokumenttype, aktør og årstall.
  • Hente aktører — Finn statlige virksomheter og organisasjoner via navn eller organisasjonsnummer.
  • Laste ned innhold — Hent ut fulltekstinnhold fra dokumenter i rent tekstformat.
  • CSV-eksport — Last ned en ferdig eksport av publiserte dokumenter i CSV-format, ideelt for periodiske uttrekk og dataanalyse.

Kom i gang

Basis-URL for alle endepunkter er https://kudos.dfo.no/api/v0. Ingen autentisering er nødvendig — API-et er åpent og fritt tilgjengelig.

Eksempel: Hent de siste dokumentene: 

GET https://kudos.dfo.no/api/v0/documents

Alle listeendepunkter returnerer paginerte resultater med inntil 50 elementer per side. Bruk page-parameteren for å bla gjennom resultater.

Respons-format

Alle endepunkter returnerer JSON. Listeendepunkter har følgende struktur: 

{
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 50,
    "total": 950
  },
  "data": [...]
}

CSV-eksport av dokumenter

Endepunktet /documents/download/csv lar deg laste ned en ferdig eksport av publiserte dokumenter i CSV-format. Filen genereres på nytt én gang i døgnet, så det er ingen grunn til å hente den oftere enn én gang per dag. Endepunktet støtter ingen query-parametere.

Filen leveres gzip-komprimert (.csv.gz) for å spare båndbredde — typisk 80–90 % mindre enn en rå CSV. Du må pakke den ut før du åpner den i regneark eller dataverktøy. På macOS og Windows holder det som regel å dobbeltklikke; i terminal kan du bruke gunzip eller gzip -d.

Format: CSV-en er Excel-kompatibel — UTF-8 med BOM, semikolon (;) som kolonneskilletegn, og CRLF-linjeskift. Den åpner direkte ved dobbeltklikk i norsk Excel. For celler med flere verdier (forfattere, filer, aktører) brukes pipe (|) som intern separator — f.eks. Tom Bola|Anna Nass.

Eksempel: Last ned CSV-eksport: 

GET https://kudos.dfo.no/api/v0/documents/download/csv

Eksempel: Last ned og pakk ut i ett steg med curl: 

curl -L https://kudos.dfo.no/api/v0/documents/download/csv | gunzip > kudos-publiserte-dokumenter.csv

Hastighetsbegrensning (Rate Limiting)

API-et har hastighetsbegrensning per IP-adresse for å sikre stabil drift:

Endepunkt Grense
Alle endepunkter (standard) 180 forespørsler per minutt, maks 5 000 per time
/documents/download/csv 2 forespørsler per minutt, maks 10 per time

Når grensen er nådd, returneres HTTP-statuskode 429 Too Many Requests. Vent til neste minutt før du prøver igjen.

Kontakt

Har du spørsmål eller tilbakemeldinger? Ta kontakt med oss på kudos@dfo.no.

Endepunkter