# Statens Penge REST API - komplet reference

> Danmarks offentlige økonomi samlet ét sted: finansloven, ekstra bevillinger, regnskaber, statens selskaber og løn i staten - fra plan til regning. 15 endpoints. Base URL: `https://www.oekonomiguiden.dk`.

Genereret af det samme register, som ruterne validerer efter. Maskinlæsbar udgave: `https://www.oekonomiguiden.dk/v1/openapi.json` (OpenAPI 3.1).

## Kom i gang

```bash
export STATENS_PENGE_API_KEY="sp_live_..."

curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/soeg?q=folkepension"
```

## Nøgle

* Send nøglen på hvert kald: `Authorization: Bearer sp_live_...`.
* Nøgler oprettes under Profil → API-nøgler på https://www.oekonomiguiden.dk/profil/api-noegler og kræver et Pro-abonnement.
* MCP-nøgler og nøgler fra Lovguiden virker ikke mod dette API; de giver 401.
* Fire ruter er offentlige: `GET /v1`, `GET /v1/docs`, `GET /v1/openapi.json` og `GET /v1/llms.txt`.

## Svar

Alle svar er JSON: `{ "data": ... }`. Beløb er i hele kroner (felter der ender på `_kr`), løbende priser. Datoer er ISO 8601. Rækker med en side på sitet har et absolut `link`.

| Header | Betydning |
| --- | --- |
| `X-Statens-Penge-Pris-DKK` | Hvad netop dette kald kostede, i kroner med to decimaler. |
| `X-Statens-Penge-Prisklasse` | Prisklassen kaldet blev afregnet efter. |
| `Cache-Control` | Altid private på datasvar, fordi de ligger bag en nøgle. Oversigten, OpenAPI, docs og llms.txt er offentlige. |

## Fejl

```json
{ "fejl": { "kode": 400, "besked": "Ukendt parameter \"aaar\". Gyldige parametre for denne rute: aar." } }
```

| Kode | Betydning | Forklaring |
| --- | --- | --- |
| 400 | Ugyldigt kald | En ukendt parameter eller en ugyldig værdi. Beskeden siger, hvad der var galt. Et filter falder aldrig stille bort. Gratis. |
| 401 | Ugyldig eller manglende nøgle | Authorization-headeren mangler, eller nøglen er ukendt eller slået fra. MCP-nøgler og Lovguiden-nøgler virker ikke her. |
| 402 | Ikke nok saldo | Kaldets pris er større end saldoen på kontoen. Beskeden oplyser begge beløb. Saldoen er fælles med Lovguiden, hvor credits købes. |
| 404 | Findes ikke | Det, du slog op, findes ikke - eller stien er ukendt. Et 404 fra et opslag koster som et almindeligt kald. |
| 429 | For mange kald | Højst 60 kald i minuttet pr. nøgle og 5.000 i døgnet pr. konto. Gratis. |
| 500 | Serverfejl | Fejl i vores ende. Kaldet koster ikke noget. Prøv igen. |

## Grænser

* 60 kald i minuttet pr. nøgle, 5.000 kald i døgnet pr. konto. Overskridelse giver 429.
* En ukendt query-parameter giver 400. Et 200-svar med nul rækker betyder altid "ingen træf".
* Lister har en `antal`-parameter med et loft. Der er ingen side-parameter - afgræns med filtrene.

## Priser

Hvert kald trækkes fra kontoens saldo, den samme som chatten bruger. Afvist før kørsel (400 på parametre, 401, 402, 429) og 5xx koster intet.

| Prisklasse | Pris pr. kald | Hvad |
| --- | --- | --- |
| `gratis` | gratis | Lister over gyldige værdier. Koster ikke noget. |
| `opslag` | 0,03 kr. | Ét år, én konto, ét aktstykke eller én profil. |
| `soegning` | 0,08 kr. | Søgning og lister med filtre på tværs af data. |

## Alle endpoints

| Endpoint | Hvad | Pris |
| --- | --- | --- |
| `GET /v1/soeg` | Søg i hele statens økonomi | 0,08 kr. |
| `GET /v1/finanslov/aar` | Finansår med data | gratis |
| `GET /v1/finanslov` | Finansloven for et år | 0,03 kr. |
| `GET /v1/finanslov/ministerium` | Et ministerium på finansloven | 0,03 kr. |
| `GET /v1/finanslov/konto` | En konto på finansloven | 0,03 kr. |
| `GET /v1/finanslov/udvikling` | Statens udgifter over tid | 0,03 kr. |
| `GET /v1/aktstykker` | Aktstykker i et folketingsår | 0,08 kr. |
| `GET /v1/aktstykker/aktstykke` | Ét aktstykke | 0,03 kr. |
| `GET /v1/regnskaber` | Statslige institutioners regnskaber | 0,08 kr. |
| `GET /v1/regnskaber/selskaber` | Statens selskaber | 0,08 kr. |
| `GET /v1/institution` | Profil for en institution eller et selskab | 0,03 kr. |
| `GET /v1/loen` | Løn i staten pr. stilling | 0,08 kr. |
| `GET /v1/loen/topchefer` | Topchefernes løn | 0,08 kr. |
| `GET /v1/sager` | Sager vi følger | 0,08 kr. |
| `GET /v1/sager/sag` | Én sag med tidslinje | 0,03 kr. |

## Søgning

### GET /v1/soeg

**Søg i hele statens økonomi.** Fritekstsøgning på tværs af finanslovens konti, ekstra bevillinger (aktstykker), institutioner og selskaber, årsrapporter, stillinger i lønstatistikken, nyheder og sager. Brug det først, når du ikke kender den præcise konto, institution eller stilling. Svaret har links, som de andre værktøjer kan slå op.

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:soeg` · MCP-værktøj: `soeg`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `q` | tekst | ja | Søgeord, fx "folkepension", "politibetjent" eller "DSB". |
| `antal` | heltal | nej | Højst så mange træf pr. type (1-25, standard 8). Standard: 8. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/soeg?q=folkepension"
```

## Finansloven

### GET /v1/finanslov/aar

**Finansår med data.** Listen over de finansår, hvor finansloven findes i databasen, nyeste først. Brug den til at finde gyldige årstal til de andre finanslov-værktøjer.

- Pris: gratis (`gratis`)
- Logges som: `v1:finanslov_aar` · MCP-værktøj: `finanslov_aar`

Ruten tager ingen parametre.

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/finanslov/aar"
```

### GET /v1/finanslov

**Finansloven for et år.** Overblik over finansloven for ét år: statens samlede udgifter, udgift pr. indbygger og hvert ministerium med beløb, ændring fra året før og link, samt de største enkeltkonti. Brug det til spørgsmål om hvad staten bruger penge på, og hvilke områder der vokser. Ekstra bevillinger i årets løb ligger i værktøjet aktstykker.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:finanslov_oversigt` · MCP-værktøj: `finanslov_oversigt`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `aar` | heltal | nej | Finansår, fx 2026. Udelades det, bruges det nyeste. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/finanslov?aar=2026"
```

### GET /v1/finanslov/ministerium

**Et ministerium på finansloven.** Ét ministerium (paragraf) på finansloven for et år: udgift, ændring fra året før, udvikling over tid, hovedkonti med beløb og ændring, forklaringer på de største ændringer, når de findes, årets ekstra bevillinger (aktstykker) og ministeriets institutioner. Brug det, når spørgsmålet handler om et bestemt ministerium eller område, fx Forsvaret eller Beskæftigelsesministeriet.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:finanslov_ministerium` · MCP-værktøj: `finanslov_ministerium`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `ministerium` | tekst | ja | Ministeriet som slug fra URL'en (fx "forsvarsministeriet"), paragrafnummer (fx "12") eller navn (fx "Forsvarsministeriet"). |
| `aar` | heltal | nej | Finansår, fx 2026. Udelades det, bruges det nyeste. |
| `antal` | heltal | nej | Højst så mange hovedkonti, største først (1-50, standard 25). Standard: 25. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/finanslov/ministerium?ministerium=forsvarsministeriet&aar=2026"
```

### GET /v1/finanslov/konto

**En konto på finansloven.** Én hovedkonto på finansloven: hvad den dækker, beløbet på finansloven år for år mod regnskabet, regeringens skøn for næste år, hvorfor beløbet har ændret sig, detaljer fra finanslovens tekst (nøgletal, fordeling, projekter, regler) og aktstykker der har flyttet penge på kontoen. Brug det, når du kender kontonummeret, fx fra soeg eller finanslov_ministerium.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:finanslov_konto` · MCP-værktøj: `finanslov_konto`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `konto` | tekst | ja | Kontonummer, fx "12.26.04" eller "122604". |
| `aar` | heltal | nej | Finansår, fx 2026. Udelades det, bruges det nyeste. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/finanslov/konto?konto=12.26.04&aar=2026"
```

### GET /v1/finanslov/udvikling

**Statens udgifter over tid.** Statens samlede udgifter på finansloven år for år (op til ti år før det valgte år), i løbende priser og pr. indbygger. Brug det til spørgsmål om, hvor meget statens udgifter er vokset.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:finanslov_udvikling` · MCP-værktøj: `finanslov_udvikling`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `aar` | heltal | nej | Finansår, fx 2026. Udelades det, bruges det nyeste. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/finanslov/udvikling?aar=2026"
```

## Ekstra bevillinger

### GET /v1/aktstykker

**Aktstykker i et folketingsår.** Aktstykker er ministeriernes anmodninger til Finansudvalget om penge eller ændringer ud over finansloven. Giver aktstykkerne i ét folketingsår med type, beløb, ministerium og link, plus årets sum af ekstra bevillinger. Kan filtreres på ministerium, tekst, type og mindste beløb. Brug det til "hvilke ekstra bevillinger blev givet" og "de største aktstykker".

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:aktstykker` · MCP-værktøj: `aktstykker`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `samling` | tekst | nej | Folketingsåret som "2025-26". Udelades det, bruges det nyeste. |
| `ministerium` | tekst | nej | Kun aktstykker fra ministerier hvis navn indeholder teksten, fx "forsvar". |
| `q` | tekst | nej | Kun aktstykker hvor titel, formål eller modtagere indeholder teksten. |
| `type` | alle \| ekstra_bevillinger \| tilfoersel \| udmoentning \| bloktilskud \| reduktion \| teknisk | nej | Type: "ekstra_bevillinger" = kun dem der tæller som ekstra penge (positivt beløb, ikke tekniske, ikke taget tilbage). Standard "alle". Standard: alle. |
| `min_kr` | tal | nej | Kun aktstykker med mindst dette beløb i hele kroner, fx 100000000. |
| `sorter` | beloeb \| dato \| nr | nej | Sortering: største beløb (standard), nyeste dato eller nyeste nummer. Standard: beloeb. |
| `antal` | heltal | nej | Højst så mange aktstykker (1-50, standard 25). Standard: 25. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/aktstykker?samling=2025-26&type=ekstra_bevillinger&antal=10"
```

### GET /v1/aktstykker/aktstykke

**Ét aktstykke.** Ét aktstykke ud fra folketingsår og nummer: titel, type, om det er nye penge, status og dato, beløb (i alt og pr. år), formål, kort resumé, berørte finanslovskonti, modtagere og link til siden og Folketingets dokument. Brug det, når du kender nummeret, fx fra aktstykker eller soeg.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:aktstykke` · MCP-værktøj: `aktstykke`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `samling` | tekst | ja | Folketingsåret som "2025-26". |
| `nr` | heltal | ja | Aktstykkets nummer, fx 88. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/aktstykker/aktstykke?samling=2025-26&nr=1"
```

## Regnskaber

### GET /v1/regnskaber

**Statslige institutioners regnskaber.** Nøgletal fra de statslige institutioners årsrapporter for ét regnskabsår: driftsudgifter, årsværk og årets resultat (overskud/underskud), størst først. Kan filtreres på navn eller ministerium. Brug det til at sammenligne styrelser, etater og universiteter; brug institution for én profil i dybden.

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:regnskaber` · MCP-værktøj: `regnskaber`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `aar` | heltal | nej | Regnskabsår, fx 2024. Udelades det, bruges det nyeste. |
| `q` | tekst | nej | Kun institutioner hvis navn eller ministerium indeholder teksten, fx "universitet". |
| `sorter` | udgifter \| aarsvaerk \| overskud \| underskud | nej | Sortering: største udgifter (standard), flest årsværk, største overskud eller største underskud. Standard: udgifter. |
| `antal` | heltal | nej | Højst så mange rækker (1-50, standard 25). Standard: 25. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/regnskaber?aar=2024&q=styrelse&antal=10"
```

### GET /v1/regnskaber/selskaber

**Statens selskaber.** Selskaber som staten ejer helt eller delvist (fx DSB, Energinet, Sund & Bælt) med nyeste regnskab: omsætning, resultat, ansatte, statens ejerandel og ansvarligt ministerium. Kommunalt ejede selskaber er ikke med. Kan filtreres på navn eller ministerium.

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:selskaber` · MCP-værktøj: `selskaber`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `q` | tekst | nej | Kun selskaber hvis navn eller ministerium indeholder teksten. |
| `sorter` | omsaetning \| resultat \| ansatte | nej | Sortering: største omsætning (standard), største resultat eller flest ansatte. Standard: omsaetning. |
| `antal` | heltal | nej | Højst så mange rækker (1-50, standard 25). Standard: 25. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/regnskaber/selskaber?antal=10"
```

### GET /v1/institution

**Profil for en institution eller et selskab.** Profil for én statslig institution, sektor eller ét statsligt selskab (fx politiet, dsb, skat): type, ministerium, penge på finansloven år for år, nøgletal fra årsrapporterne, løn og topledelse, seneste begivenheder og de sager, den indgår i. Brug soeg for at finde sluggen.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:institution` · MCP-værktøj: `institution`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `slug` | tekst | ja | Profilens slug fra URL'en, fx "politiet" eller "dsb". |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/institution?slug=politiet"
```

## Løn

### GET /v1/loen

**Løn i staten pr. stilling.** Månedsløn i staten pr. stillingskategori (fx politibetjente, gymnasielærere, jurister): gennemsnit, median og kvartiler, antal årsværk, kønsforskel og lønudvikling siden 2020 før og efter prisstigninger. Uden søgetekst gives statens gennemsnit og de største stillinger. Brug det til "hvad tjener en ... i staten".

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:loen` · MCP-værktøj: `loen`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `q` | tekst | nej | Stilling eller dens kode, fx "politi", "lærer" eller "303". Udelades det, gives de største stillinger. |
| `sorter` | aarsvaerk \| loen | nej | Sortering: flest årsværk (standard) eller højeste gennemsnitsløn. Standard: aarsvaerk. |
| `antal` | heltal | nej | Højst så mange stillinger (1-50, standard 15). Standard: 15. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/loen?q=politi"
```

### GET /v1/loen/topchefer

**Topchefernes løn.** Årlig løn til departementschefer i ministerierne og vederlag til direktionerne i statens selskaber (fra årsregnskaberne), med bonusordninger. Kan filtreres på navn eller institution. Brug det til spørgsmål om topchefløn i staten.

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:topchefer` · MCP-værktøj: `topchefer`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `q` | tekst | nej | Kun personer eller institutioner hvis navn indeholder teksten, fx "DSB" eller "Finansministeriet". |
| `antal` | heltal | nej | Højst så mange pr. liste (1-50, standard 25). Standard: 25. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/loen/topchefer?antal=10"
```

## Sager

### GET /v1/sager

**Sager vi følger.** De sager om statens penge, som sitet følger over tid (fx en kampflykøb, en reform eller et sygehusbyggeri): titel, periode, tema, antal begivenheder, involverede institutioner og seneste nyt. Kan filtreres på tema og tekst. Brug sag for hele tidslinjen.

- Pris: 0,08 kr. (`soegning`)
- Logges som: `v1:sager` · MCP-værktøj: `sager`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `tema` | tekst | nej | Kun sager i temaet. Mulige: sundhed, boern-og-uddannelse, aeldre-og-social, transport, forsvar-politi-og-ret, energi-og-forsyning, erhverv-skat-og-staten, kultur-og-medier. |
| `q` | tekst | nej | Kun sager hvor titlen eller en involveret institution indeholder teksten. |
| `status` | alle \| aktive | nej | "aktive" = kun sager med nyt inden for det seneste år. Standard "alle". Standard: alle. |
| `antal` | heltal | nej | Højst så mange sager, nyeste først (1-50, standard 25). Standard: 25. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/sager?tema=sundhed&antal=10"
```

### GET /v1/sager/sag

**Én sag med tidslinje.** Én sag med beskrivelse og tidslinje: begivenhederne (bevillinger, besparelser, advarsler, aftaler, finanslovsændringer) med dato, kort resumé, beløb for den enkelte begivenhed, kilde og link. Beløbene må ikke lægges sammen til et samlet tal for sagen; de overlapper ofte. Brug sager for at finde sluggen.

- Pris: 0,03 kr. (`opslag`)
- Logges som: `v1:sag` · MCP-værktøj: `sag`

| Parameter | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- |
| `slug` | tekst | ja | Sagens slug fra URL'en (fra sager). |
| `antal` | heltal | nej | Højst så mange begivenheder, de nyeste (1-50, standard 40). Standard: 40. |

```bash
curl -H "Authorization: Bearer $STATENS_PENGE_API_KEY" \
  "https://www.oekonomiguiden.dk/v1/sager/sag?slug=banedanmark-storstr%C3%B8msbroen&antal=20"
```

## Videre

* Interaktiv reference (Swagger UI): https://www.oekonomiguiden.dk/v1/docs
* OpenAPI 3.1: https://www.oekonomiguiden.dk/v1/openapi.json
* MCP-server med de samme værktøjer: https://www.oekonomiguiden.dk/api/mcp (se https://www.oekonomiguiden.dk/udviklere/mcp)
* Kilder og metode: https://www.oekonomiguiden.dk/om-tallene