Regnskab API til danske årsregnskaber

DataCVR's regnskab API er den del af vores CVR API, der giver dig regnskaberne. Dit system sender et CVR-nummer og får virksomhedens regnskaber tilbage som JSON. Hvert regnskab har regnskabsår, periode, offentliggørelsesdato, valuta, links til kildefilerne og op til 20 felter fra omsætning til egenkapitalforrentning. Det er data, der kan gå direkte ind i en kreditmodel, et CRM eller et regnskabssystem.

Regnskabsdata kræver Business-planen til 499 kr. om måneden ekskl. moms eller en højere plan. Vil du vide mere om selve årsrapporten, så læs guiden til årsregnskaber.

Endpoints

Basis-URL'en er https://datacvrapi.dk/api/v2, og nøglen sendes i headeren X-API-Key.

GET /api/v2/dk/company/{cvr}/accounts giver alle regnskaber for en virksomhed. Med limit styrer du antallet, som er 10 som standard og højst 100. Med from_year og to_year afgrænser du årene, og de to parametre virker kun for danske virksomheder.

GET /api/v2/dk/company/{cvr}/accounts/latest giver det nyeste helårsregnskab, og GET /api/v2/dk/search/accounts søger regnskaber på tværs af virksomheder. Søgningen findes kun for Danmark. Norske regnskaber henter du fra Brønnøysund med GET /api/v2/no/company/{orgnr}/accounts.

Et kald efter det nyeste helårsregnskab ser sådan ud:

curl -H "X-API-Key: DIN_NØGLE" https://datacvrapi.dk/api/v2/dk/company/24256790/accounts/latest

Svaret har denne struktur:

{
  "cvr": ...,
  "report_id": ...,
  "document_type": "aarsrapport",
  "fiscal_year": ...,
  "period_start": ...,
  "period_end": ...,
  "publication_date": ...,
  "currency": ...,
  "xbrl_url": ...,
  "ixbrl_url": ...,
  "figures": {
    "revenue": ...,
    "equity": ...,
    "equity_ratio": ...
  }
}

Her er kun tre af felterne i figures vist. Alle parametre og fejlkoder står i dokumentationen.

Op til 20 felter i figures

Feltnavnene er på engelsk. Tabellen viser det danske regnskabsbegreb ud for hvert felt, så du kan koble dem til din egen model. Et felt står kun i svaret, når regnskabet har tallet. Hvad nøgletallene betyder, og hvordan de læses, står i guiden til nøgletal.

Små virksomheder oplyser typisk bruttofortjeneste i stedet for omsætning, så hos dem står gross_profit langt oftere end revenue. Gæld i alt får du som total_liabilities minus equity, fordi feltet er passiver i alt.

Skal tallene bruges til at vurdere en kunde eller leverandør, så læs kreditvurdering af virksomheder.

Dækning og rapporttyper

Tallene går typisk tilbage til 2012. For nogle børsnoterede selskaber starter de først mellem 2014 og 2016. Ældre rapporter står også i listen, men uden tal. Feltet document_type fortæller, om rapporten er en årsrapport (aarsrapport), en halvårsrapport (halvaarsrapport) eller en delårsrapport (delaarsrapport). Typen kommer fra Virk og er ikke altid rigtig. Et kvartal kan være mærket aarsrapport, og typen koncernregnskab findes også.

Skal du kun bruge helårstal, så vælg de regnskaber, hvor perioden fra period_start til period_end er mindst 350 dage. Det er samme regel, som /accounts/latest selv bruger.

Fra XBRL og iXBRL til JSON

Virksomhederne indberetter deres regnskaber til Erhvervsstyrelsen som XBRL- og iXBRL-filer. Vi læser nøgletallene ud af de filer, også når regnskabet er aflagt efter IFRS, og henter data fra Virk, når du spørger. Felterne xbrl_url og ixbrl_url peger på kildefilerne, hvis du vil se tallene i sammenhæng.

Skal du kun se ét regnskab, er regnskaber.virk.dk det rigtige sted. Det er den officielle portal, den er gratis, og du kan se og hente den enkelte rapport som PDF og XBRL. DataCVR er bygget til det andet behov: nøgletallene som JSON i ét kald og på tværs af år.

Pris og 403-svaret

Regnskabsdata følger med Business-planen til 499 kr. om måneden og Business+ til 699 kr. om måneden, begge ekskl. moms og uden binding. Kalder du et regnskabs-endpoint med en nøgle på Gratis, Start eller Hobby, svarer API'et med HTTP 403 og koden TIER_REQUIRED:

{
  "error": "TIER_REQUIRED",
  "message": "Regnskabsdata kræver Business plan eller højere. Se datacvrapi.dk/priser"
}

Fang koden i din integration, så brugeren får en forklaring i stedet for en tom visning. Alle planer står på priser.