Grundlæggende
- Basis-URL:
https://apicvr.dk - Autentificering: ingen – ingen konto, ingen API-nøgle
- Format: JSON (UTF-8). CORS er slået til, så du kan kalde API'et direkte fra browseren
- Data: live opslag i Erhvervsstyrelsens CVR-distribution (distribution.virk.dk)
- Rate limits: fair use. Skal du bruge vedvarende høj trafik, så skriv til [email protected]
curl https://apicvr.dk/api/v1/41013583Hent virksomhed på CVR-nummer
Den fulde virksomhedsprofil: navn, adresse, kontaktoplysninger, branchekode, virksomhedsform, status, antal ansatte, reklamebeskyttelse, alle P-enheder samt nuværende direktion, fuldt ansvarlige deltagere og legale ejere.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
cvrNumber |
sti | integer |
CVR-nummer på 8 cifre. |
curl "https://apicvr.dk/api/v1/41013583"Direktion, fuldt ansvarlige og ejere
Et slankt svar med kun de personer og selskaber, der aktuelt leder eller ejer virksomheden. Ejere har ejerandel og stemmeret både som tal og som CVR's intervaller (fx 25-33,32%).
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
cvrNumber |
sti | integer |
CVR-nummer på 8 cifre. |
curl "https://apicvr.dk/api/v1/41013583/direktion-og-ansvarlig"Kombineret søgning på navn og/eller CVR
Søg på navn (præfiks), CVR-nummer eller begge. Mindst én af parametrene er påkrævet.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
name |
query | string |
Virksomhedsnavn (præfiks). |
cvr |
query | integer |
CVR-nummer på 8 cifre. |
limit |
query | integer |
Maks. antal resultater (standard 100). |
curl "https://apicvr.dk/api/v1/search?name=novo&limit=5"Fejltolerant navnesøgning (autocomplete)
Finder virksomheden selv med stavefejl og returnerer et slankt svar med navn, CVR-nummer og branche. Lavet til autocomplete-felter.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
companyName |
sti | string |
Virksomhedsnavn eller en del af det. |
limit |
query | integer |
Maks. antal resultater (standard 100). |
curl "https://apicvr.dk/api/v1/search/fuzzy/novo%20nordsk?limit=5"Søg på adresse
Find alle virksomheder registreret på en adresse. Søgningen prøver først et eksakt match, derefter vejnavn og husnummer og til sidst et fejltolerant match. Angiv postal_code for at afgrænse til ét postnummer.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
address |
query | string |
Vejnavn og husnummer, fx Novo Allé 1. |
postal_code |
query | string |
Postnummer på 4 cifre. |
limit |
query | integer |
Maks. antal resultater (standard 100). |
curl "https://apicvr.dk/api/v1/search/address?address=Novo%20All%C3%A9%201&postal_code=2880"Søg på email
Find virksomheder, der har den angivne email registreret offentligt i CVR.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
email |
sti | string |
Fuld emailadresse. |
limit |
query | integer |
Maks. antal resultater (standard 100). |
curl "https://apicvr.dk/api/v1/search/email/[email protected]"Søg på emaildomæne
Find virksomheder, hvis registrerede email ligger på domænet. Godt til at koble en B2B-lead eller en ny bruger til den rigtige virksomhed.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
domain |
sti | string |
Domæne uden @, fx firma.dk. |
limit |
query | integer |
Maks. antal resultater (standard 100). |
curl "https://apicvr.dk/api/v1/search/email-domain/novonordisk.com"Søg på telefonnummer
Find virksomheder med telefonnummeret registreret offentligt i CVR.
| Parameter | Placering | Type | Beskrivelse |
|---|---|---|---|
phone |
sti | string |
Telefonnummer, 8 cifre uden landekode. |
limit |
query | integer |
Maks. antal resultater (standard 100). |
curl "https://apicvr.dk/api/v1/search/phone/44448888"Svarfelter
Gælder /api/v1/{cvrNumber} og søge-endpoints (søgninger udelader P-enheder og relationer). Felter uden værdi er null.
| Felt | Type | Beskrivelse |
|---|---|---|
vat | integer | CVR-nummeret (8 cifre). |
name | string | Nuværende navn. |
address | string | Vejnavn, husnummer, etage og dør. |
zipcode | integer | Postnummer. |
city | string | By (postdistrikt). |
cityname | string | Bynavn, hvis det adskiller sig fra postdistriktet. |
addressco | string | c/o-adresse. |
protected | boolean | true hvis virksomheden har reklamebeskyttelse. |
phone | string | Offentligt registreret telefonnummer. |
email | string | Offentligt registreret email. |
website | string | Hjemmeside, hvis registreret. |
startdate | string | Stiftelsesdato (ÅÅÅÅ-MM-DD). |
enddate | string | Ophørsdato, ellers null. |
employees | integer | Antal ansatte (seneste indberetning). |
industrycode | integer | Branchekode (DB07, 6 cifre). |
industrydesc | string | Branchebeskrivelse. |
companycode | integer | Kode for virksomhedsform. |
companydesc | string | Virksomhedsform, fx Aktieselskab. |
companytypeshort | string | Kort virksomhedsform, fx A/S eller ApS. |
status | string | Fx NORMAL, OPHØRT eller UNDERKONKURS. |
bankrupt | boolean | true hvis virksomheden er under konkurs. |
p_units | PUnit[] | Liste over produktionsenheder (P-enheder) med adresse, branche og ansatte. |
direktion | Direktor[] | Nuværende direktører. |
fuldt_ansvarlige | FuldtAnsvarlig[] | Deltagere med personlig, ubegrænset hæftelse. |
ejere | Ejer[] | Legale ejere med ejerandel og stemmeret. |
Fejlkoder
Fejl returneres som {"detail": {"error": "KODE", "message": "…"}}.
| HTTP | Kode | Beskrivelse |
|---|---|---|
400 | MISSING_QUERY | /api/v1/search blev kaldt uden name eller cvr. |
404 | NOT_FOUND | Ingen virksomhed med det CVR-nummer. |
422 | – | En parameter har forkert type, fx et CVR-nummer med bogstaver. |
502 | HTTP_ERROR | Erhvervsstyrelsens CVR-distribution svarede med en fejl. Prøv igen. |
502 | TRANSPORT_ERROR | CVR-distributionen kunne ikke nås. Prøv igen om lidt. |
Vil du prøve kald med egne parametre, så brug Interaktiv Swagger-dokumentation · OpenAPI-specifikation