API og MCP

Hent selskaber, årsrapporter, ledelse og ejere som JSON, eller lad en AI-assistent slå dem op gennem MCP. Data kommer fra CVR og Erhvervsstyrelsen og leveres, som de er registreret. Alle svar har et felt meta.kilde. API'et læser kun fra vores database; et selskab, vi ikke har, svarer 404.

Adgang

API-adgang følger pakkerne Pro (10.000 kald om måneden) og Business (100.000 kald). Opret en nøgle under Min konto, API-nøgler, og send den i hvert kald:

Authorization: Bearer cvrdb_…

Hvert svar har X-RateLimit-Limit og X-RateLimit-Remaining for måneden. Der kan højst sendes 120 kald i minuttet pr. nøgle. Når kvoten er brugt, svarer API'et 429 med besked om, hvornår den nulstilles.

Hvad tæller som ét kald

Én forespørgsel er ét kald, uanset hvad den returnerer. Et svar med en fejl (ukendt CVR-nummer, ugyldigt filter) tæller også; en forespørgsel, der stoppes af nøglekontrollen eller minutgrænsen, tæller ikke.
/firma: ét selskab med alle årsrapporter. /soeg: én side med højst 100 selskaber. /sammenlign: op til 10 (Pro) eller 25 (Business) selskaber. /aendringer: ét selskab, højst 500 ændringer.
MCP: hvert værktøjskald er ét kald fra samme månedlige kvote; opkobling og listen over værktøjer er gratis.
Filtre på regnskabstal og vækst i /soeg er med i begge pakker.

Endpoints

GET /api/v1/firma/{cvr}

Selskab, årsrapporter år for år, aktuel ledelse, ejere, revisor og placering i branchen.

curl -H "Authorization: Bearer $CVRDB_KEY" https://cvrdatabase.dk/api/v1/firma/35954716

GET /api/v1/soeg

Avanceret søgning. Mindst ét filter: q, branche (kode eller navn), kommune (slug), form, ansMin/ansMax, ekMin/ekMax (egenkapital, mio. kr.), resMin/resMax, brMin/brMax, omMin/omMax, alderMin/alderMax (år). Ændring i procent, seneste regnskabsår mod året før: brVaekstMin/brVaekstMax (bruttofortjeneste), ekVaekstMin/ekVaekstMax (egenkapital), resVaekstMin/resVaekstMax (resultat) og omVaekstMin/omVaekstMax (omsætning). De rammer kun selskaber med regnskab for to år i træk og et tal over nul i det tidligere år (omsætning: oplyst begge år); et manglende tal gættes aldrig. Et resultat har så aendring_pct med de ændringer, du har filtreret på. Dertil sort, dir, side og antal (højst 100).

curl -H "Authorization: Bearer $CVRDB_KEY" \
  "https://cvrdatabase.dk/api/v1/soeg?kommune=aarhus&ansMin=500&sort=ansatte"

GET /api/v1/sammenlign?cvr=a,b,c

Selskaber side om side med seneste årsrapport. Op til 10 (Pro) eller 25 (Business).

GET /api/v1/aendringer?cvr=…&since=ÅÅÅÅ-MM-DD

Ændringer i et selskab, som de er registreret: navn, adresse, status, ledelse, ejere, branche og offentliggjorte årsrapporter.

MCP til AI-assistenter

MCP-serveren ligger på https://cvrdatabase.dk/api/mcp (JSON-RPC over HTTP) med værktøjerne search_companies, get_company, compare_companies og get_changes. Kun værktøjskald tæller med i kvoten. Tilføj den i en MCP-klient, der understøtter fjernservere:

{
  "mcpServers": {
    "cvrdatabase": {
      "url": "https://cvrdatabase.dk/api/mcp",
      "headers": { "Authorization": "Bearer cvrdb_…" }
    }
  }
}

Klienter har forskellige krav til fjernservere; følg klientens vejledning for HTTP-servere med egne headers.

Vilkår for data

Selskaber, der er reklamebeskyttet, har reklamebeskyttet: true og en bemærkning. Oplysninger om dem må ikke bruges til markedsføring, og markeringen skal følge med, hvis du giver dem videre. Du må ikke bruge API'et til at kopiere hele databasen eller til at omgå grænserne. Se vilkårene.