cvrdev/virksomhed/search
Dette endpoint returnerer information om alle virksomheder, der matcher alle givne 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 (over et sekund) for første request; det er helt nyt, og vi har endnu ikke en god forståelse af hvilke attributter, der oftest bliver søgt på.
OBS: loven om reklamebeskyttelse skal overholdes.
Dette endpoint er inkluderet i Business og Business Pro-abonnementer.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
pagination_id | number | Id på paginering til næste side - denne værdi eksisterer i svaret på forespørgsler, hvor der er flere virksomheder tilbage end limit tillader at sende | |
hovedbranchekoder | string | Disse findes på https://erst.virk.dk/branchekode/soeg/indexSoeg | |
virksomhedsformer | string | Eksempelvis ENK (enkeltmand), ApS (anpartsselskab), FFO (frivillig forening), I/S (interessentselskab), PMV (personligt ejet mindre virksomhed), A/S (aktieselskab), FOR (forening) | |
postnumre | string | Disse findes på https://api.dataforsyningen.dk/postnumre | |
kommunekoder | string | Disse findes på https://danmarksadresser.dk/adressedata/kodelister/kommunekodeliste | |
stiftelsesdato_min | string | ||
stiftelsesdato_max | string | ||
reklamebeskyttet | boolean | Om virksomheden har fravalgt at modtage opsøgende salg. OBS: det er et lovkrav at overholde dette. Se https://datacvr.virk.dk/artikel/vilkaar-og-betingelser#accordion-5-button | |
limit | number | Maksimale antal svar ønsket i forespørgslen. Maksimalt 100. | |
ansatte_min | number | Minimum antal ansatte ved virksomhedens seneste registrering | |
ansatte_max | number | Maksimum antal ansatte ved virksomhedens seneste registrering | |
aarsvaerk_min | number | Minimum årsværk ved virksomhedens seneste registrering | |
aarsvaerk_max | number | Maksimum årsværk ved virksomhedens seneste registrering | |
kontaktoplysninger | boolean | Om virksomheden har kontaktoplysninger registreret i CVR. OBS: reklamebeskyttelse skal overholdes |
RESPONSES
status: OK
{"pagination_token":null,"virksomheder":[{"reklamebeskyttet":false,"navn":"ZITELAB ApS","cvr_nummer":29178364,"adresse":"Solsortvej 44, 2000 Frederiksberg","virksomhedsform":"APS","stiftelsesdato":"2005-11-17T00:00:00Z","hovedbranche_kode":"620100","ansatte_aarsvaerk_offentliggjort":"2024-04-01T00:00:00Z","ansatte_seneste_offentliggoerelse":10,"aarsvaerk_seneste_offentliggoerelse":8,"kontaktoplysninger":["38888613","nielssteenkrogh@zitelab.dk"]},{"reklamebeskyttet":false,"navn":"Iternum ApS","cvr_nummer":36990147,"adresse":"Falkoner Alle 20, 4, 2000 Frederiksberg","virksomhedsform":"APS","stiftelsesdato":"2015-08-15T00:00:00Z","hovedbranche_kode":"620200","ansatte_aarsvaerk_offentliggjort":"2024-04-01T00:00:00Z","ansatte_seneste_offentliggoerelse":24,"aarsvaerk_seneste_offentliggoerelse":23,"kontaktoplysninger":["32121100","info@iternumdigital.com"]},{"reklamebeskyttet":false,"navn":"CSIS SECURITY GROUP A/S","cvr_nummer":29523355,"adresse":"Lindevangs Alle 12, 3, 2000 Frederiksberg","virksomhedsform":"A/S","stiftelsesdato":"2006-05-01T00:00:00Z","hovedbranche_kode":"620100","ansatte_aarsvaerk_offentliggjort":"2024-04-01T00:00:00Z","ansatte_seneste_offentliggoerelse":78,"aarsvaerk_seneste_offentliggoerelse":75,"kontaktoplysninger":["kontakt@csis.dk"]}]}