API docs

Autentificér med en bearer API-nøgle. Alle endpoints er read-only og returnerer JSON.

Autentificering

Send din API-nøgle i Authorization-headeren.

Authorization: Bearer <api_key>

Kvoter + rate limits

Free: 100 returneringer/måned. Betalte planer: 100.000/måned. Rate limits håndhæves pr. API-nøgle.

Forbrug og afregning

Søgning/ autocomplete tæller pr. returneret resultat (fx limit=20 → op til 20 units).

GET /api/v1/company/:cvr

Fetch the latest merged company snapshot. Use ?asOf=YYYY-MM-DD for historical state.

https://cvrhub.dk/api/v1/company/16079944

GET /api/v1/search

Full-text search with cursor-based pagination.

https://cvrhub.dk/api/v1/search?query=software&limit=20

GET /api/v1/autocomplete

Typeahead suggestions. Returns CVR + company name.

https://cvrhub.dk/api/v1/autocomplete?query=novo&limit=10

GET /api/v1/status

Returns your plan, quota, remaining returns, and rate limit info.

https://cvrhub.dk/api/v1/status

Pagination

Cursor er en 'fortsæt herfra'-token. Brug meta.nextCursor fra svaret, og send den tilbage som ?cursor=... sammen med limit. Hvis nextCursor er null, er der ikke flere resultater.

/api/v1/search?query=software&limit=100
/api/v1/search?query=software&limit=100&cursor=eyJvZmZzZXQiOiIxMDAifQ==

Fejlformat

Fejl returnerer error.code og error.message. 402 bruges ved kvote overskredet.

{
  "error": { "code": "quota_exceeded", "message": "Monthly quota exceeded." }
}

Svarformat

Succesfulde svar returnerer data og meta. Fejl returnerer et error-objekt med code og message. data / meta / error.

200, 400, 401, 403, 404, 429, 500
402 for quota exceeded