REST APIv1

API-dokumentation

Integrer dansk virksomhedsdata direkte i dine applikationer. Søg i 700.000+ virksomheder, berig med AI og byg automatiserede workflows.

Base URL

https://app.cvrbase.dk/api

Autentificering

API-nøgle via x-api-key header

Svartid

Gennemsnitlig < 50ms

Format

JSON over HTTPS

Autentificering

Alle API-kald kræver en gyldig API-nøgle sendt via x-api-key headeren. Du kan oprette og administrere dine API-nøgler i indstillingerne i din CVRbase-konto.

API-adgang er knyttet til Pro, Team Starter, Team Pro og Enterprise-planerne. Under lanceringen er selvbetjent opgradering låst, så API-planer åbnes senere eller manuelt af CVRbase. Se priser

bash
curl https://app.cvrbase.dk/api/v1/companies/search?query=software \
  -H "x-api-key: your_api_key_here"

Kom i gang

Tre trin til dit første API-kald.

1

Opret en CVRbase-konto

Tilmeld dig og opret din konto. API-planer vises allerede, men selvbetjent aktivering åbner først med den fulde billing-lancering.

2

Generer en API-nøgle

Gå til Indstillinger → API og opret en ny nøgle. Gem den sikkert — den vises kun én gang.

3

Lav dit første kald

Søg efter softwarevirksomheder i København:

bash
curl "https://app.cvrbase.dk/api/v1/companies/search?query=software&municipalityCodes=101&employeeRange[min]=10" \
  -H "x-api-key: sk_live_your_key_here"

Eller med JavaScript:

javascript
const response = await fetch(
  "https://app.cvrbase.dk/api/v1/companies/search?" +
    new URLSearchParams({
      query: "software",
      "municipalityCodes[]": "101",
      "employeeRange[min]": "10",
    }),
  {
    headers: {
      "x-api-key": "sk_live_your_key_here",
    },
  }
);

const data = await response.json();
console.log(`Found ${data.found} companies`);

Python:

python
import requests

response = requests.get(
    "https://app.cvrbase.dk/api/v1/companies/search",
    params={
        "query": "software",
        "municipalityCodes[]": "101",
        "employeeRange[min]": 10,
    },
    headers={"x-api-key": "sk_live_your_key_here"},
)

data = response.json()
print(f"Found {data['found']} companies")

Virksomheder

Søg og slå op i data på alle aktive og ophørte danske virksomheder.

Muligheder (/v1/opportunities)

Modtag og spor muligheder fra dine salgsystemer. Muligheder repræsenterer aktive pipelineforløb på virksomheder og oprettes typisk fra dit CRM eller dialer via API.

Lister

Opret og administrer virksomhedslister. Tilføj virksomheder, importer fra CSV og eksporter data.

AI-berigelse

Berig virksomhedsdata med AI. Få B2B/B2C-klassificering, nøgleord, teknologier og meget mere.

Insights & Analyse

Databaseret analyse af din kundebase. Byg Ideal Customer Profiles, analysér churn-risiko og optimér din pipeline.

Egne felter

Definer branchespecifikke datapunkter (f.eks. ERP-system, segment) og sæt værdier pr. opportunity eller virksomhed. Bruges automatisk i scoring og insights.

Webhooks

Modtag real-time notifikationer når virksomhedsdata ændrer sig eller nye virksomheder matcher dine kriterier.

Pipelines

Konfigurér separate pipelines til forskellige produkter eller segmenter. Hver pipeline har sine egne stadier, scoring-model og lead-rangeringer.

Event-typer

Definer dine egne event-typer til at spore touchpoints. Event-typer bruges i scoring, filtrering og ekskluderingslister.

Kontakter

Letvægts-kontaktpersoner der kan knyttes til flere virksomheder og muligheder. CVRbase er ikke et CRM — kontakter bruges til at berige og linke data.

Rate limits & kvoter

Kvoter nulstilles den 1. i hver måned. Enterprise-kunder kan få tilpassede grænser.

PlanSøgningerEksporterAI-berigelserAPI-adgang
Free100/md---
Starter1.000/md100/md50/md-
Pro10.000/md1.000/md500/md
Team Starter1.000/md100/md50/md
Team Pro10.000/md1.000/md500/md
EnterpriseUbegrænsetUbegrænsetUbegrænset

Fejlkoder

API’en returnerer standard HTTP-statuskoder. Alle fejlresponses inkluderer et JSON-objekt med et error felt.

json
{
  "error": {
    "code": 422,
    "message": "Invalid CVR number: must be exactly 8 digits",
    "field": "cvr"
  }
}
KodeNavnBeskrivelse
401UnauthorizedManglende eller ugyldig API-nøgle.
403ForbiddenDin plan inkluderer ikke API-adgang, eller du har overskredet din kvota.
404Not FoundDen forespurgte ressource (virksomhed, mulighed, liste) blev ikke fundet.
422Validation ErrorUgyldige parametre. Se fejlmeddelelsen for detaljer.
429Rate LimitedDu har overskredet din rate limit. Vent og prøv igen med exponential backoff.
500Server ErrorEn uventet fejl opstod. Kontakt support hvis problemet fortsætter.

SDK & Libraries

Officielle client libraries gør det nemt at integrere CVRbase i din applikation.

Node.js / TypeScript

npm install @cvrbase/sdk
Kommer snart

Python

pip install cvrbase
Kommer snart

Klar til at bygge?

Opret en konto under lanceringen. API-adgang aktiveres på relevante planer eller manuelt af CVRbase. Brug for hjælp? Kontakt os på support@cvrbase.dk