API-dokumentation

Kom i gang

Brug API'et i to trin: Få en API-nøgle, og lav dit første kald.

Trin 1
Opret en konto og generér en API-nøgle
API-adgang kræver et betalt abonnement (Basic eller Pro). Du kan oprette og tilbagekalde nøgler under Dashboard → API-nøgler.
Trin 2
Lav dit første opslag
Send en GET-forespørgsel med din nøgle som Bearer-token:
curl
```
curl -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://cvrlookup.dk/api/v1/company/37520556"
```
Du får et JSON-svar med fulde virksomhedsdetaljer. Kald gerne samme CVR igen samme dag — gentagelser er gratis.

Prøv det live

Interaktivt eksperiment direkte fra dokumentationen — kommer snart.

Try-It-widget kommer snart

Indtast et CVR-nummer, vælg endpoint og se det rå JSON-svar — uden at forlade siden. I mellemtiden kan du teste alle endpoints med eksemplerne nedenfor.

Godkendelse

Alle endpoints under /api/v1 kræver en gyldig API-nøgle sendt som Bearer-token i Authorization-headeren.

header

Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Nøgler har præfiks cvr_ og er knyttet til den bruger, der oprettede dem.
Hold dine nøgler hemmelige — de giver fuld adgang til dit forbrug og kvoter. Tilbagekald kompromitterede nøgler øjeblikkeligt fra dashboardet.
Manglende eller ugyldig header giver 401 UNAUTHORIZED.
Som svar på autoriserede kald sender vi følgende rate-limit-headers: X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset (Unix-tidsstempel).

Endpoints

REST-endpoints under base-URL'en bliver dokumenteret nedenfor med parametre, eksempler og fuldt svarskema.

Base-URL: https://cvrlookup.dk

GET/api/v1/search

Søg virksomheder

Søg på virksomhedsnavn (gratis, tæller ikke mod kvoten) eller slå op på et 8-cifret CVR-nummer (forbruger 1 daglig kvote-enhed). Anvend enten 'name' eller 'cvr'.

Parametre

Navn	Type	Påkrævet	Standard	Beskrivelse
name	string	Enten 'name' eller 'cvr'	—	Søg på virksomhedsnavn (max 100 tegn). Returnerer minimal data. Gratis.
cvr	string	Enten 'name' eller 'cvr'	—	8-cifret CVR-nummer. Returnerer fuld virksomhedsdata. Tæller mod daglig kvote (kun ved første opslag pr. dag).
limit	number	Valgfri	10	Antal resultater (1-50). Kun relevant for navnesøgning.
offset	number	Valgfri	0	Pagination offset. Kun relevant for navnesøgning.
status	"all" \| "active" \| "inactive"	Valgfri	"all"	Filtrer på aktiv-status.

Eksempelforespørgsel

curl

curl -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://cvrlookup.dk/api/v1/search?name=Codepilots&limit=10"

Eksempelsvar

json

{
  "success": true,
  "data": {
    "companies": [
      {
        "cvr": "37520556",
        "companyName": "Codepilots ApS",
        "companyType": "Anpartsselskab",
        "city": "København K",
        "isActive": true
      }
    ],
    "total": 1,
    "query": "Codepilots",
    "limit": 10,
    "offset": 0,
    "took": 42
  },
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "hasMore": false
  }
}

Svarskema

Felterne nedenfor er indpakket under data i det rå svar (fx data.cvr).

Felt	Type	Beskrivelse
companies[].cvr	string	8-cifret CVR-nummer.
companies[].companyName	string	Virksomhedsnavn.
companies[].companyType	string?	Virksomhedsform (lang eller kort beskrivelse).
companies[].city	string?	By / postdistrikt.
companies[].isActive	boolean	Aktiv-status.
total	number	Samlet antal matchende virksomheder.
query	string	Den brugte søgestreng.
limit	number	Anvendt limit.
offset	number	Anvendt offset.
took	number	Eksekveringstid (ms).
meta.page	number	Aktuel side (1-indekseret).
meta.hasMore	boolean	Findes der flere resultater?

Bemærk

Navnesøgning returnerer minimal data — brug 'GET /api/v1/company/{cvr}' for fulde detaljer.
CVR-opslag via dette endpoint returnerer fuldt CVRCompany-objekt (samme skema som /company/{cvr}).

GET/api/v1/company/{cvr}

Hent virksomhed efter CVR

Returnerer fulde detaljer for én virksomhed. Forbruger 1 daglig kvote-enhed pr. unikt CVR pr. dag — gentagne opslag samme dag er gratis.

Parametre

Navn	Type	Påkrævet	Standard	Beskrivelse
cvr	string (path)	Påkrævet	—	Præcis 8 cifre, fx 37520556.

Eksempelforespørgsel

curl

curl -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://cvrlookup.dk/api/v1/company/37520556"

Eksempelsvar

json

{
  "success": true,
  "data": {
    "cvr": "37520556",
    "companyName": "Codepilots ApS",
    "status": "ACTIVE",
    "isActive": true,
    "companyType": {
      "code": 80,
      "shortDescription": "ApS",
      "longDescription": "Anpartsselskab"
    },
    "address": {
      "street": "Eksempelgade",
      "houseNumber": "1",
      "postalCode": "1050",
      "city": "København K",
      "country": "DK",
      "fullAddress": "Eksempelgade 1, 1050 København K"
    },
    "industry": {
      "code": "620100",
      "description": "Computerprogrammering"
    },
    "shareCapital": { "amount": 40000, "currency": "DKK" },
    "owners": [
      {
        "name": "Eksempel Person",
        "role": "Reel ejer",
        "ownershipShare": "100%",
        "entityType": "PERSON"
      }
    ],
    "foundedDate": "2016-04-01",
    "lastUpdated": "2026-04-15"
  }
}

Svarskema

Felterne nedenfor er indpakket under data i det rå svar (fx data.cvr).

Felt	Type	Beskrivelse
cvr	string	8-cifret CVR-nummer.
companyName	string	Officielt virksomhedsnavn (nyeste).
tradeNames	string[]?	Binavne / alternative navne.
status	"ACTIVE" \| "DISSOLVED" \| "BANKRUPTCY" \| "RECONSTRUCTION" \| "UNKNOWN"	Normaliseret status.
statusText	string?	Original statustekst fra CVR.
isActive	boolean	Hurtig flag for aktiv-status.
creditStatus.code	number?	Kreditoplysningskode.
creditStatus.text	string?	Kreditoplysningstekst.
companyType.code	number?	Virksomhedsformskode.
companyType.shortDescription	string?	Kort beskrivelse, fx "A/S".
companyType.longDescription	string?	Lang beskrivelse, fx "Aktieselskab".
address.street	string?	Vejnavn.
address.houseNumber	string?	Husnummer.
address.floor	string?	Etage.
address.door	string?	Side/dør.
address.postalCode	string?	Postnummer.
address.city	string?	Postdistrikt / by.
address.coName	string?	C/O-navn.
address.municipality	string?	Kommunenavn.
address.municipalityCode	number?	Kommunekode.
address.country	string	ISO landekode (fx "DK").
address.fullAddress	string?	Sammenfletning af adressefelter.
postalAddress.*	object?	Separat postadresse hvis forskellig fra beliggenhedsadresse.
industry.code	string?	Branchekode (NACE).
industry.description	string?	Branchetekst.
secondaryIndustries[].code	string?	Sekundære branchekoder.
secondaryIndustries[].description	string?	Sekundære branchetekster.
employeeInfo.year	number?	År for senest rapporterede beskæftigelse.
employeeInfo.quarter	number?	Kvartal (1-4).
employeeInfo.employees	number?	Antal ansatte.
employeeInfo.employeesIncludingOwners	number?	Antal inkl. ejere.
employeeInfo.fullTimeEquivalent	number?	Årsværk.
employeeInfo.employeeInterval	string?	Intervalkode for ansatte (fx "10-19").
contact.phone	string?	Telefonnummer.
contact.secondaryPhone	string?	Sekundær telefon.
contact.fax	string?	Fax.
contact.email	string?	E-mail.
contact.mandatoryEmail	string?	Obligatorisk e-mail (digital post).
contact.website	string?	Hjemmeside.
registrationNumbers	string[]?	Reg.numre (P-numre, banker mv.).
signatureRule	string?	Tegningsregel.
owners[].name	string?	Ejer-navn.
owners[].role	string?	Rolle.
owners[].address	string?	Adresse.
owners[].ownershipShare	string?	Ejerandel (fx "50%-66.66%").
owners[].votingShare	string?	Stemmeandel.
owners[].startDate	string?	Startdato (ISO).
owners[].entityType	"PERSON" \| "VIRKSOMHED"?	Type af ejer.
owners[].cvr	string?	CVR hvis ejer er virksomhed.
boardMembers[]	object[]?	Bestyrelse / direktion. Felter: name, role, title, address, entityType, cvr.
founders[]	object[]?	Stiftere. Felter: name, address, entityType, cvr.
auditors[]	object[]?	Revisorer. Felter: name, address, entityType, cvr.
accountants[]	object[]?	Regnskabsfolk.
foundedDate	string?	Stiftelsesdato (ISO).
dissolvedDate	string?	Opløsningsdato (ISO).
startDate	string?	Første registreringsdato.
effectDate	string?	Virkningsdato.
lastUpdated	string	Sidst opdateret (ISO).
lastLoaded	string?	Sidst indlæst i CVR-distribution.
advertisingProtection	boolean?	Reklamebeskyttet.
productionUnits	number?	Antal P-enheder.
unitNumber	number?	EnhedsNummer (intern).
shareCapital.amount	number?	Selskabskapital.
shareCapital.currency	string?	Valuta (fx "DKK").
companyPurpose	string?	Formål.
accountingPeriod.startMonth	number?	Regnskabsår startmåned (1-12).
accountingPeriod.startDay	number?	Regnskabsår startdag.
accountingPeriod.endMonth	number?	Regnskabsår slutmåned.
accountingPeriod.endDay	number?	Regnskabsår slutdag.
firstAccountingPeriod.start	string?	Første regnskabsår start.
firstAccountingPeriod.end	string?	Første regnskabsår slut.
auditExempt	boolean?	Revision fravalgt.
latestArticlesDate	string?	Seneste vedtægtsdato.

Bemærk

Felter markeret med '?' kan være null/undefined hvis CVR-registret ikke har data for dem.
Tilføj 'Accept: application/xml' for at få svaret i XML i stedet for JSON.

GET/api/v1/usage

Forbrug og kvoter

Returnerer aktuel kvote-status (dag, måned, minut) samt aggregeret forbrug for den valgte periode. Fri at kalde — tæller ikke mod kvoten.

Parametre

Navn	Type	Påkrævet	Standard	Beskrivelse
period	"day" \| "week" \| "month"	Valgfri	"day"	Hvor langt tilbage opsummering skal dække.

Eksempelforespørgsel

curl

curl -H "Authorization: Bearer cvr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://cvrlookup.dk/api/v1/usage?period=week"

Eksempelsvar

json

{
  "success": true,
  "data": {
    "quota": {
      "daily":   { "limit": 100, "used": 12, "remaining": 88 },
      "monthly": { "limit": 2000, "used": 240, "remaining": 1760 },
      "rateLimit": { "perMinute": 20, "currentUsage": 0, "remaining": 20 },
      "resetTime": "2026-05-05T00:00:00.000Z"
    },
    "usage": {
      "period": "day",
      "startDate": "2026-05-04",
      "endDate": "2026-05-04",
      "totalCalls": 14,
      "successfulCalls": 14,
      "failedCalls": 0,
      "successRate": "100.00",
      "avgResponseTime": 122,
      "totalResultsReturned": 14
    },
    "breakdown": {
      "byQueryType": { "cvr": 12, "name": 2 },
      "daily": [
        { "date": "2026-05-04", "calls": 14, "successfulCalls": 14 }
      ]
    }
  }
}

Svarskema

Felterne nedenfor er indpakket under data i det rå svar (fx data.cvr).

Felt	Type	Beskrivelse
quota.daily.limit	number	Daglig kvote ifølge dit abonnement.
quota.daily.used	number	Antal unikke CVR-opslag i dag.
quota.daily.remaining	number	Resterende daglig kvote.
quota.monthly.limit	number	Månedlig kvote.
quota.monthly.used	number	Forbrug i indeværende måned.
quota.monthly.remaining	number	Resterende månedlig kvote.
quota.rateLimit.perMinute	number	Tilladte CVR-opslag pr. minut.
quota.rateLimit.currentUsage	number	Forbrug i de seneste 60 sekunder.
quota.rateLimit.remaining	number	Resterende minut-kvote.
quota.resetTime	string	ISO-tidsstempel for næste midnatsreset.
usage.period	"day" \| "week" \| "month"	Anvendt periode.
usage.startDate	string	Start på rapportperiode (YYYY-MM-DD).
usage.endDate	string	Slut (YYYY-MM-DD).
usage.totalCalls	number	Samlet antal API-kald.
usage.successfulCalls	number	Antal succesfulde kald (HTTP 2xx eller 404).
usage.failedCalls	number	Antal fejlede kald.
usage.successRate	string	Procent som tekst (fx "98.50").
usage.avgResponseTime	number	Gennemsnitlig svartid (ms).
usage.totalResultsReturned	number	Samlet antal returnerede resultater.
breakdown.byQueryType	Record<string, number>	Antal kald grupperet på queryType ("cvr" / "name").
breakdown.daily[].date	string	YYYY-MM-DD.
breakdown.daily[].calls	number	Kald den dag.
breakdown.daily[].successfulCalls	number	Succesfulde kald den dag.

Rate limits & kvoter

Opslag på CVR-numre tæller mod en daglig kvote og en pr.-minut grænse. Navnesøgning er gratis. Det samme CVR slået op flere gange samme dag tæller kun én gang.

Plan	Pris	Pr. dag	Pr. måned	Pr. minut	REST API
Gratis	0 kr/måned	10	100	5	Ikke inkluderet
Basic	49 kr/måned	100	2.000	20	Inkluderet
Pro	99 kr/måned	500	10.000	60	Inkluderet

Daglige kvoter nulstilles ved midnat (CET). Tidspunktet for næste reset returneres i headeren X-RateLimit-Reset.
Når en grænse rammes, svarer vi med HTTP 429 og fejlkode RATE_LIMIT_EXCEEDED eller QUOTA_EXCEEDED.
Endpointet GET /api/v1/usage returnerer dit aktuelle forbrug — uden at tælle mod kvoten.

Behov for større kvoter?

Skriv til support, så finder vi en plan der passer dit volumen. Se aktuelle priser

Fejlkoder

Alle fejl returneres med samme JSON-skema og en HTTP-statuskode. Felterne 'code' og 'message' er stabile — undgå at parse 'message' for logik.

json

{
  "success": false,
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Daglig kvote overskredet. Opgradér din plan for flere opslag."
  }
}

Kode	HTTP	Beskrivelse
UNAUTHORIZED	401	Manglende eller ugyldig API-nøgle. Tjek 'Authorization'-headeren.
INVALID_API_KEY	401	API-nøglen kunne ikke valideres (måske tilbagekaldt eller udløbet).
FORBIDDEN	403	Autentificeret, men din konto har ikke adgang til endpointet.
INVALID_REQUEST	400	Forespørgslen er ugyldig (fx ukendt værdi til 'period').
INVALID_CVR	400	CVR-nummer skal være præcis 8 cifre.
MISSING_PARAMETER	400	Hverken 'name' eller 'cvr' blev angivet til /search.
RATE_LIMIT_EXCEEDED	429	For mange anmodninger pr. minut. Vent og prøv igen.
QUOTA_EXCEEDED	429	Daglig kvote opbrugt. Opgradér plan eller vent til midnat.
COMPANY_NOT_FOUND	404	Ingen virksomhed med det angivne CVR-nummer.
NOT_FOUND	404	Ressourcen findes ikke.
CVR_API_ERROR	500	Fejl fra det underliggende CVR-register hos Erhvervsstyrelsen.
SERVICE_UNAVAILABLE	503	Midlertidigt utilgængelig — ofte fordi kvote-tjek fejlede.
INTERNAL_ERROR	500	Uventet serverfejl. Prøv igen, eller kontakt support hvis det fortsætter.

Kom i gang#

Opret en konto og generér en API-nøgle

Lav dit første opslag

Prøv det live#

Try-It-widget kommer snart

Godkendelse#

Endpoints#

Søg virksomheder

Parametre

Eksempelforespørgsel

Eksempelsvar

Svarskema

Bemærk

Hent virksomhed efter CVR

Parametre

Eksempelforespørgsel

Eksempelsvar

Svarskema

Bemærk

Forbrug og kvoter

Parametre

Eksempelforespørgsel

Eksempelsvar

Svarskema

Rate limits & kvoter#

Behov for større kvoter?

Fejlkoder#

Kom i gang

Prøv det live

Godkendelse

Endpoints

Rate limits & kvoter

Fejlkoder