Hop til hovedindhold

cvr.dev API dokumentation (1.2)

Introduktion

Velkommen til cvr.dev's HTTP API dokumentation.

Dette dokument beskriver, hvordan du kan benytte vores API til at hente CVR-data. Vi henter og cacher data fra Virks CVR-database en gang i minuttet, så vi altid kan levere så nøjagtig data som muligt.

Udover at være beskrevet på denne sige, er vores API også beskrevet i OpenAPI 3.0 format og som Postman-dokumentation.

For at benytte vores API skal du have en cvr.dev-konto med et aktivt abonnement, som du kan prøve gratis de første 30 dage.

Reklamebeskyttelse

Alle brugere skal, når de laver en konto, tilkendegive at de har til hensigt at følge loven om reklamebeskyttelse. Det er ulovligt at lave reklamehenvendelser til virksomheder, der er reklamebeskyttet i CVR.

Læs mere her: https://datacvr.virk.dk/artikel/vilkaar-og-betingelser#accordion-5-button

Autentificering

For at benytte vores API skal du have en cvr.dev-konto og oprette en API key på hjemmesiden.

Dine API keys er personlige og skal sendes med i alle requests. Din API key skal medsendes som en såkaldt Bearer token og sættes i Authorization-headeren, som vist her:

Authorization: Bearer din-api-key

Du kan teste, om du medsender din API key korrekt, ved at benytte vores Test API key endpoint

Test API key

Dette endpoint lader dig teste om du medsender din API key korrekt. Dette endpoint tæller ikke med i dit månedlige forbrug.

Dine API keys er personlige og skal sendes med i alle requests. Din API key skal sættes i Authorization-headeren, som vist her:

Authorization: Bearer din-api-key

Authorizations:
APIKey

Responses

Response samples

Content type
application/json
{
  • "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Rå-data fra CVR

Disse endpoints returnerer rå-data fra CVR-registret, som den kommer fra Virk. Dataformaterne i disse endpoints er derfor bestemt af Virk, ikke af cvr.dev.

Endpoints i denne kategori er inkluderet i alle vores abonnementer.

Udover eksemplerne på returdata givet ude i højre side, er der en uddybende beskrivelse af data for hvert endpoint ved den grønne 200-kode under Responses i hvert endpoint.

Data om Virksomheder

Dette endpoint returnerer alt data om en virksomhed, som den er i CVR. Dette dataformat er bestemt af Virk, ikke af cvr.dev.

Data

Bemærk feltet virksomhedMetadata, der indeholder en simplificeret opsummering af resten af data. Det er meget ofte denne information, man ønsker at benytte.

Query parametre

OBS: Sendes begge query parametre samtidig, vil kun cvr_nummer blive brugt.

Authorizations:
APIKey
query Parameters
cvr_nummer
string
Example: cvr_nummer=10103940

CVR-nummer på virksomheden, der søges efter

navn
string
Example: navn=Statsministeriet, Departementet

Navn på virksomheden, der søges efter

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Data om Produktionsenheder

Dette endpoint returnerer alt data om en produktionsenhed, som den er i CVR. Dette dataformat er bestemt af Virk, ikke af cvr.dev.

Data

Bemærk feltet produktionsEnhedMetadata, der indeholder en simplificeret opsummering af resten af data. Det er meget ofte denne information, man ønsker at benytte.

Query parametre

OBS: Sendes begge query parametre samtidig, vil kun p_nummer blive brugt.

Authorizations:
APIKey
query Parameters
p_nummer
string
Example: p_nummer=1004862579

P-nummer på produktionsenheden, der søges efter

adresse
string
Example: adresse=Nybrovej 410 2800

Adresse på produktionsenheden, der søges efter

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Ejerskabshierarki

Disse endpoints returnerer information vedr. ejerskabsforholdene for en given virksomhed eller person. Denne data er afledt fra en eller flere kilder, inklusiv rå-data fra CVR. Dataformaterne i disse endpoints er bestemt af cvr.dev.

Endpoints i denne kategori er ikke inkluderet i vores Starter-abonnement.

Udover eksemplerne på returdata givet ude i højre side, er der en uddybende beskrivelse af data for hvert endpoint ved den grønne 200-kode under Responses i hvert endpoint.

Data om virksomheds datterselskaber

Dette endpoint returnerer hierarkiet af alle datterselskaber som enheden (person eller virksomhed) står noteret som ejer for i CVR-registret. Denne data inkluderer enhedens omtrentlige ejerskab og stemmerettigheder, som det er angivet i CVR.

Ejerskab og stemmeret udgør ikke altid 100%

Den danske lovgivning gør, at det ikke altid er muligt at se ejerne af en virksomhed. Eksempelvis siger Selskabslovens § 55, at det kun er ejere med en kapitalandel eller stemmeret over 5%, der skal offentliggøres.

Der er andre tilfælde, hvor eksempelvis en virksomheds ledelse er noteret som ejere, hvor ejerskabet ikke fremgår direkte af CVRs data.

Query parametre

OBS: Sendes begge query parametre samtidig, vil kun enhedsnummer blive brugt.

Authorizations:
APIKey
query Parameters
cvr_nummer
string
Example: cvr_nummer=10582989

CVR-nummer på virksomheden, hvis datterselskaber ønskes

enhedsnummer
string
Example: enhedsnummer=2337773

Enhedsnummer på enheden (virksomhed eller person), hvis datterselskaber ønskes

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Data om virksomheds ejere

Dette endpoint returnerer hierarkiet af alle enheder der, direkte eller indirekte, er noteret som ejere af den givne virksomhed i CVR-registret. Denne data inkluderer enhedens omtrentlige ejerskab og stemmerettigheder, som det er angivet i CVR.

Ejerskab og stemmeret udgør ikke altid 100%

Den danske lovgivning gør, at det ikke altid er muligt at se ejerne af en virksomhed. Eksempelvis siger Selskabslovens § 55, at det kun er ejere med en kapitalandel eller stemmeret over 5%, der skal offentliggøres.

Der er andre tilfælde, hvor eksempelvis en virksomheds ledelse er noteret som ejere, hvor ejerskabet ikke fremgår direkte af CVRs data.

Query parametre

OBS: Sendes begge query parametre samtidig, vil kun enhedsnummer blive brugt.

Authorizations:
APIKey
query Parameters
cvr_nummer
string
Example: cvr_nummer=10582989

CVR-nummer på virksomheden, hvis ejerhierarki ønskes

enhedsnummer
string
Example: enhedsnummer=2337773

Enhedsnummer på virksomheden, hvis ejerhierarki ønskes

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Segmentering

Disse endpoints muliggør segmentering af virksomheder baseret på diverse parametre. Denne data er afledt fra en eller flere kilder, inklusiv rå-data fra CVR. Dataformaterne i disse endpoints er bestemt af cvr.dev.

Endpoints i denne kategori er ikke inkluderet i vores Starter-abonnement.

Udover eksemplerne på returdata givet ude i højre side, er der en uddybende beskrivelse af data for hvert endpoint ved den grønne 200-kode under Responses i hvert endpoint.

Segmentering af virksomheder

Dette endpoint returnerer information om alle virksomheder, der matcher samtlige parametre. Dette kan eksempelvis benyttes til segmentering af potentielle kunder. Endpointet er pagineret og kan returnere op til 100 virksomheder per forespørgsel.

Vær opmærksom på at dette endpoint i nogle tilfælde kan være langsomt, specielt første paginerede side; endpointet er helt nyt, og vi har endnu ikke en god forståelse af hvilke attributter, der oftest bliver søgt på sammen.

OBS: loven om reklamebeskyttelse skal overholdes.

Authorizations:
APIKey
query Parameters
pagination_id
integer <int64>
Example: pagination_id=123456

Token som benyttes til at hente næste batch, såfremt der er flere virksomheder tilbage i søgningen

hovedbranchekoder
string
Example: hovedbranchekoder=642020,620100

Komma-separerede hovedbranchekoder, uden punktummer. Branchekoder kan findes her https://erst.virk.dk/branchekode/soeg/indexSoeg

virksomhedsformer
string
Example: virksomhedsformer=ApS,A/S

Komma-separerede virksomhedsformer, eksempelvis ENK (enkeltmand), ApS (anpartsselskab), FFO (frivillig forening), I/S (interessentselskab), PMV (personligt ejet mindre virksomhed), A/S (aktieselskab), FOR (forening), EFO (erhvervsdrivende forening) med flere

postnumre
string
Example: postnumre=8000,2000

Komma-separerede postnumre for den registrerede hovedadresse. Postnumre kan findes på https://api.dataforsyningen.dk/postnumre

kommunekoder
string
Example: kommunekoder=0101,0147

Komma-separerede kommunekoder for den registrerede hovedadresse. Kommunekoder kan findes på https://danmarksadresser.dk/adressedata/kodelister/kommunekodeliste

stiftelsesdato_min
string <date>
Example: stiftelsesdato_min=2020-04-21

Dato fra og med hvornår virksomheden tidligst må være stiftet

stiftelsesdato_max
string <date>
Example: stiftelsesdato_max=2023-04-21

Dato til og med hvornår virksomheden senest må være stiftet

reklamebeskyttet
boolean
Example: reklamebeskyttet=false

Om virksomheden skal være reklamebeskyttet eller ej. Denne skal være false for virksomheder, du ønsker at kontakte med henblik på salg

kontaktoplysninger
boolean
Example: kontaktoplysninger=true

Om virksomheden skal have kontaktoplysninger registreret i CVR

ansatte_min
integer <int32>
Example: ansatte_min=5

Det minimale antal ansatte virksomheden skal have haft ved virksomhedens seneste registrering af ansatte

ansatte_max
integer <int32>
Example: ansatte_max=25

Det maksimale antal ansatte virksomheden skal have haft ved virksomhedens seneste registrering af ansatte

aarsvaerk_min
number <float>
Example: aarsvaerk_min=0.5

Det minimale antal årsværk virksomheden skal have haft ved virksomhedens seneste registrering af ansatte

aarsvaerk_max
number <float>
Example: aarsvaerk_max=7.5

Det maksimale antal årsværk virksomheden skal have haft ved virksomhedens seneste registrering af ansatte

limit
integer <int32>
Example: limit=50

Det maksimale antal af virksomheder, der må returneres i hver forespørgsel

Responses

Response samples

Content type
application/json
{
  • "pagination_token": 123456,
  • "virksomheder": [
    ]
}