Hvorfor vælge et CVR API fra FirmaAPI?

Når man først begynder at arbejde med CVR-data, virker opgaven ofte enkel: Man skal bruge et CVR-nummer, et firmanavn, en adresse eller måske et regnskab.

I praksis bliver det hurtigt mere omfattende.

Data skal hentes, fortolkes, normaliseres og holdes opdateret. Regnskaber skal samles på tværs af formater. Historik skal forstås. Ændringer skal opdateres. Søgning skal være hurtig, også når brugeren filtrerer på branche, kommune, status, ansatte og økonomi på samme tid.

Det er den del af arbejdet, FirmaAPI er bygget til.

FirmaAPI er et dansk CVR API for udviklere, virksomheder og AI-værktøjer, der har brug for virksomhedsdata i en form, der kan bruges direkte i jeres eget system. Ikke som et færdigt svar på alle forretningsspørgsmål, men som et solidt datagrundlag, der sparer dig for meget af det arbejde, man ellers ender med at bygge selv.

Hvad er problemet med CVR-data?

CVR-data er værdifulde, fordi de beskriver virksomheder, ejere, ledelse, adresser, brancher, status, regnskaber og historiske ændringer. Men værdien kommer først rigtigt frem, når dataene er gjort brugbare.

Hvis du selv bygger en integration direkte med rå registerdata, skal du typisk tage stilling til spørgsmål som:

Hvordan vælger vi den rigtige version af et regnskab?
Hvordan håndterer vi felter, der mangler i nogle selskaber, men ikke i andre?
Hvordan omsætter vi koder til navne, uden at vores egne mapping-tabeller bliver forældede?
Hvordan opdager vi, at en virksomhed har skiftet status?
Hvordan undgår vi at hente de samme uændrede virksomheder igen og igen?
Hvordan søger vi hurtigt i data, når brugeren kombinerer mange filtre?

Det er ikke umuligt. Men det tager tid, og det kræver løbende vedligeholdelse.

FirmaAPI er bygget ud fra den erfaring: De fleste har ikke brug for endnu et sted at hente rådata. De har brug for et API, hvor det mest besværlige forarbejde allerede er gjort.

Det vi gør anderledes

Der findes flere måder at få adgang til virksomhedsdata på.

Du kan hente rå data og bygge hele datalaget selv. Det giver maksimal kontrol, men er også utroligt tungt og besværligt at arbejde med.

Du kan bruge et simpelt opslag, der returnerer et JSON-svar tæt på kilden. Det kan være fint til små behov, men meget af arbejdet ligger stadig hos dig.

Du kan vælge en stor dataleverandør med tunge aftaler og lange implementeringsforløb. Det kan give mening i større organisationer, men er ofte mere, end et produktteam eller en udvikler har brug for.

FirmaAPI har lagt sit fokus et andet sted. Det er lavet som et praktisk, moderne API til danske virksomhedsdata, hvor opslag, søgning, regnskaber, historik, relationer, webhooks, sandbox og MCP hænger sammen.

Det vigtige er ikke kun, at du kan slå et CVR-nummer op. Det vigtige er, hvad du slipper for at bygge rundt om opslaget.

Et API bør gøre mere end at sende data videre

Når du slår en virksomhed op i FirmaAPI, får du ikke bare et råt udtræk. Data bliver bearbejdet, så de er nemmere at bruge i en applikation.

Det gælder blandt andet:

Regnskaber bliver parseret fra XBRL og inline XBRL/XHTML, så centrale regnskabstal kan returneres i et mere ensartet format.
Nøgletal bliver beregnet for årsrapporter, når de underliggende tal er til stede. Det gælder blandt andet overskudsgrad, bruttomargin, ROA, ROE, soliditetsgrad og gældsgrad.
Væksttal bliver beregnet mellem sammenlignelige perioder, så et halvårsregnskab ikke bliver sammenlignet direkte med et helt regnskabsår.
Dubletter og varianter håndteres, så du ikke selv skal vælge mellem flere versioner af samme regnskabsperiode.
Personer samles i profiler, så den samme person kan genkendes på tværs af roller og virksomheder.
Kommuner, regioner og brancher beriges, så du ikke kun står med interne koder.
Hændelser afledes fra ændringer i data, så statusændringer, fusioner, spaltninger og regnskabsoffentliggørelser kan bruges mere direkte.

Det er den slags arbejde, der sjældent fylder i en produktbeskrivelse, men som betyder meget i en integration.

Færre kald, mindre sammenfletning

Et almindeligt problem i API-integrationer er, at man skal hente flere dele af samme virksomhed hver for sig.

Først stamdata. Så regnskaber. Så historik. Så P-enheder. Så relationer. Til sidst skal man selv samle det hele, håndtere fejl undervejs og sikre, at alle svar passer til samme virksomhed.

I FirmaAPI kan du bruge include til at hente ekstra datablokke i samme opslag:

GET /api/v1/company/12345678?include=finance,history,production_units,relations,events

De understøttede include-værdier er:

finance - regnskabsdata
history - historiske ændringer
production_units - P-enheder
relations - direkte moder- og datterselskabsrelationer
events - afledte livscyklushændelser

Adgangen afhænger af din plan. Standard giver blandt andet adgang til seneste årsregnskab, P-enheder og hændelser. Professionel og Enterprise giver adgang til flere regnskabsår, relationer og flere detaljer.

Hvis du bruger en ukendt include-værdi, får du en konkret fejl med de gyldige værdier. Hvis din plan ikke giver adgang til en bestemt blok, får du at vide, hvad der kræves. Det er små ting i dokumentationen, men store ting i hverdagen, når en integration skal bygges og vedligeholdes.

Søgning er en selvstændig disciplin

Mange starter med navnesøgning. Ret hurtigt opstår de mere praktiske spørgsmål:

“Find aktive anpartsselskaber i København.”

“Find produktionsvirksomheder i Region Midtjylland med mindst 20 ansatte.”

“Find virksomheder i en bestemt branche, der har regnskabsdata og en registreret hjemmeside.”

Den slags søgninger bør ikke køre direkte på rå virksomhedsdata. Derfor bruger FirmaAPI et særskilt søgeindeks med felter, der er forberedt til filtrering: status, branche, kommune, ansatte, kapital, omsætning, kontaktoplysninger, stiftelsesdato og flere andre.

Når en virksomhed ændrer sig, bliver søgeindekset opdateret via en kø. På den måde kan søgning holdes adskilt fra tungere opdateringsarbejde.

For dig betyder det, at du kan bygge søgefunktioner, segmentering, leadlister og analyseværktøjer oven på et API, der er forberedt til den type brug.

Regnskaber uden egen parser

Regnskaber er et af de områder, hvor CVR-data hurtigt bliver krævende.

Der kan være forskel på rapporttyper, felter, detaljeringsgrad og perioder. Nogle selskaber har fyldige rapporter. Andre har få oplysninger. Nogle tal kan bruges til nøgletal. Andre bør ikke bruges i den sammenhæng.

FirmaAPI gør regnskaberne mere anvendelige ved at normalisere centrale felter og beregne nøgletal, når grundlaget er til stede.

Planerne er bevidst enkle:

Standard giver adgang til seneste årsregnskab med nøgletal.
Professionel og Enterprise giver adgang til op til fem års regnskaber samt udvidede felter som vækst, pengestrømme, revisionsoplysninger og delårs-/kvartalsrapporter, når data findes.

Hvis et nøgletal ikke kan beregnes forsvarligt, returneres feltet som null. Det er bedre end et pænt, men forkert tal.

Webhooks i stedet for tunge natjobs

Hvis du har et CRM, et kunderegister, en compliance-proces eller et kreditflow, har du brug for at opdage ændringer.

Den klassiske løsning er et synkroniseringsjob, der kører hver nat og sammenligner data med gårsdagens version. Det kan fungere, men det bruger tid og kvota på virksomheder, der måske slet ikke har ændret sig.

FirmaAPI understøtter webhooks, så du kan abonnere på relevante ændringer.

Standard-planen giver adgang til statusændringer og konkurser. Professionel og Enterprise giver adgang til det fulde katalog af virksomheds- og personhændelser samt filtre i FirmaAPI, så du kun modtager hændelser for relevante virksomheder, brancher eller områder.

Hændelserne dækker blandt andet:

statusændringer og konkurser
navne- og adresseændringer
branche-, type- og kapitalændringer
nye regnskabsoffentliggørelser
deltagerændringer
fusioner og spaltninger
personhændelser som ny profil, ny tilknytning, afsluttet tilknytning, rolleændring og ejerændring

Webhook-leveringer signeres med HMAC, så du kan verificere afsenderen. Hvis dit endpoint fejler midlertidigt, forsøger FirmaAPI igen med stigende intervaller. Efter gentagne fejl markeres leveringen som fejlet, og webhooks kan deaktiveres for at beskytte både dit system og vores.

Det gør webhooks velegnede til systemer, hvor ændringer skal opdages løbende, men hvor det vil være unødigt tungt at hente alt igen.

Sandbox til udvikling og test

FirmaAPI understøtter sandbox via API-nøgler med cvr_test_-præfiks. Sandbox-kald bruger syntetiske testdata og tæller ikke mod din kvota.

Det gør det muligt at teste:

almindelige succesforløb
fejlscenarier
include-parametre
webhook-opsætning
CI-tests og lokal udvikling

Når integrationen er klar, kan du skifte til en live-nøgle.

MCP-server til AI-værktøjer

Mange bruger i dag AI-værktøjer som en del af deres udvikling, analyse eller interne arbejdsgange. Derfor har FirmaAPI en officiel MCP-server.

MCP-serveren gør det muligt for en AI-assistent at slå virksomheder op, søge i data, hente regnskaber, analysere relationer og bruge FirmaAPI’s værktøjer direkte.

Installér i din terminal med:

npm install -g firmaapi-mcp-server

Serveren indeholder 33 værktøjer fordelt på opslag, søgning, regnskaber, relationer, personer, due diligence, branchedata og forklaringer af CVR- og ERST-begreber.

Det betyder ikke, at AI’en selv skal træffe beslutninger. Det betyder, at den kan arbejde på et bedre datagrundlag, når du beder den undersøge en virksomhed, finde relevante segmenter eller sammenligne selskaber.

Fejlbeskeder og headers, der kan bruges

Et API skal være tydeligt, også når noget går galt.

FirmaAPI returnerer strukturerede fejl med kode og forklaring. Ved rate limits får du rate-limit headers og en retry_after, så dit system kan afvente korrekt inden næste forespørgsel sendes til api'et. Svar kan også indeholde Server-Timing, som gør det lettere at se, hvor tiden bliver brugt, når du undersøger svartider.

Det er ikke den mest synlige del af produktet, men det er en vigtig del af en god udvikleroplevelse.

Bygget til drift, ikke kun demo

Virksomhedsdata ændrer sig hele tiden. Derfor er FirmaAPI bygget med synkronisering mod erhvervsstyrelsens data der er max 15 minutter gammelt og cachelag for hurtig respons gennem vores api.

Søgeindekset opdateres løbende med de nyeste data. Webhooks leveres instant ved ny data og ved løbende retries ved fejlede leveringer til modtageren. Regnskaber synkroniseres separat. Redis bruges til cache og rate limiting.

Priser, der er til at gennemskue

FirmaAPI har en enkel prismodel:

Plan	Pris	Opslag/md	Rate/sek	Regnskaber	Webhooks
Gratis	0 kr.	1.000	2	-	-
Basis	79 kr.	50.000	5	-	-
Standard	299 kr.	150.000	10	Seneste 1 år	Status + konkurs
Professionel	469 kr.	500.000	20	Op til 5 år	Virksomheds- og personhændelser + filtre
Enterprise	Aftalt	1.000.000+	50+	Op til 5 år	Virksomheds- og personhændelser + filtre

Gratis-planen kræver ikke kreditkort. Du kan teste vores api gratis, bygge din integration og først opgradere, når du får et reelt behov.

Kom i gang

Du kan oprette en konto og lave dit første opslag på få minutter.

Opret en konto og få 1.000 gratis opslag om måneden.
Læs dokumentationen for endpoints, felter, include-værdier og webhooks.
Se priserne, hvis du ved, at du får brug for mere end gratis-planen.
Brug en API-nøgle med cvr_test_-præfiks, hvis du vil teste mod sandbox.
Installer MCP-serveren med npm install -g firmaapi-mcp-server, hvis du vil give din AI-assistent adgang til FirmaAPI.

FirmaAPI er bygget til dig, der gerne vil bruge CVR-data uden at bruge uger på at bygge og vedligeholde alt det, der ligger rundt om dataene.