Spring til indhold

Grundfast
Det Centrale Virksomhedsregister (CVR)

CVR-API med adresse og ejendom — samme nøgle

Slå en virksomhed op på CVR-nummeret og få navn, status, branche og beliggenhedsadresse i ét rent svar. Adressen er en rigtig DAR-adresse, så samme nøgle kan gå videre til ejendommen: BFE-nummer, bygning og vurdering.

Ortofoto © Klimadatastyrelsen · via Grundfast

Dortheavej 8, 2400 København NV

Adresser · DAR

svarede efter 5 ms

7 adresser · Dortheavej 8 m.fl.

Alle adgangsadresser på samme BFE

Adresse
Dortheavej 8, 2400 København NV
DAR-id
0a3f507a-5d41-32b8-e044-0003ba298018
Adresser på BFE
7
UTM 32N
721.572 · 6.179.243
GET /v1/adgangsadresser/bfe/6022499Prøv en anden adresse

Én ejendom, live

Hvilken virksomhed bor her?

En virksomheds adresse er en rigtig DAR-adresse — så CVR-nummeret fører hele vejen til ejendommen.

Eksempler
  • Adresse
    Dortheavej 8, 2400 København NV
    DAR-id
    0a3f507a-5d41-32b8-e044-0003ba298018
    Adresser på BFE
    7
    UTM 32N
    721.572 · 6.179.243
    $.adresser
    [{"betegnelse": "Dortheavej 8, 2400 København NV","adgangsadresse_id": "0a3f507a-5d41-32b8-e044-0003ba298018","postnr": "2400","postnrnavn": "København NV","koordinat": {"lon": 12.526959,"lat": 55.708216}},{"betegnelse": "Dortheavej 10, 2400 København NV","adgangsadresse_id": "0a3f507a-5d42-32b8-e044-0003ba298018","postnr": "2400","postnrnavn": "København NV","koordinat": {"lon": 12.526741,"lat": 55.708453}},// … 5 mere]
    curl "https://api.grundfast.dk/v1/adgangsadresser/bfe/6022499" \
      -H "Authorization: Bearer $GRUNDFAST_API_KEY"

    svarede efter 5 ms i sammensætningenMere om Adresser →

Henter virksomheden …

GET /v1/demo/cvr

Hvad du får

Virksomhedsposten — og hvor den bor

Datafordeleren spreder en virksomhed over en håndfuld CVR-entiteter med koder. Et opslag hos os giver den tilbage samlet og oversat.

  1. Posten, samlet

    Navn, status, selskabsform, branche og datoer i ét fladt svar — koderne er allerede oversat til tekst.

  2. Adressen med navne

    Beliggenhedsadressen på én linje og i felter, med kommune- og regionsnavn, så en liste kan grupperes geografisk uden flere opslag.

  3. Videre til ejendommen

    Adressen vaskes til et BFE-nummer, og derfra er bygningen, matriklen og vurderingen med samme nøgle — se databerigelse.

  4. Kun virksomheden

    Vi bruger aldrig CVR’s personentitet, og reklamebeskyttet følger med, så en markedsføringsliste kan respektere den.

GET /v1/cvr/20213094 · uddragjson
{
  "virksomhed": {
    "cvr": "20213094",
    "navn": "LAGKAGEHUSET A/S",
    "email": null,
    "status": "aktiv",
    "adresse": {
      "doer": null,
      "etage": null,
      "husnr": "10",
      "postnr": "2400",
      "vejnavn": "Dortheavej",
      "betegnelse": "Dortheavej 10, 2400 København NV",
      "postnrnavn": "København NV",
      "kommunekode": "0101",
      "region_navn": "Region Hovedstaden",
      "regionskode": "1084",
      "kommune_navn": "København"
    },
    "branche": { "kode": "107120", "tekst": "Fremstilling af friske bageriprodukter" },
    "telefon": null,
    "startdato": "1997-06-27",
    "hjemmeside": null,
    "ophoersdato": null,
    "virksomhedsform": "Aktieselskab",
    "reklamebeskyttet": null
  }
}

Kæden

CVR-nummer til ejendom i tre kald

Virksomheden, adressen i DAR og ejendommen under den. Det er den kobling, en ren CVR-kilde ikke kan lave — her er det samme nøgle og samme svarform hele vejen.

GET/v1/demo/cvr → adresse → ejendom
klar

  1. CVR-nummer → virksomhed

    /v1/cvr/:cvr

  2. Adresse → DAR og BFE

    /v1/datavask/adgangsadresser

  3. BFE → ejendommen

    /v1/bbr/ejendom/:bfe

Trin 1 er demoens faste virksomhed; med din nøgle slår /v1/cvr/:cvr ethvert CVR-nummer op. Trin 2 og 3 er rigtige opslag på virksomhedens adresse i DAR, Matriklen, BBR og vurderingen.
# 1) CVR-nummer → virksomheden og dens adresse
curl -H "Authorization: Bearer gf_live_…" \
  https://api.grundfast.dk/v1/cvr/20213094

# 2) Adressen → DAR-adresse og BFE-nummer
curl -G -H "Authorization: Bearer gf_live_…" \
  https://api.grundfast.dk/v1/datavask/adgangsadresser \
  --data-urlencode "betegnelse=Dortheavej 10, 2400 København NV"

# 3) BFE-nummeret → ejendommen
curl -H "Authorization: Bearer gf_live_…" \
  https://api.grundfast.dk/v1/bbr/ejendom/6022499
Felter i virksomhedsposten
FeltIndhold
navn · cvrVirksomhedens aktuelle navn og CVR-nummer.
statusNormaliseret livsforløb, fx aktiv, ophørt eller underkonkurs.
virksomhedsformSelskabsformen i klartekst, fx “Anpartsselskab”.
branche.kode · tekstDB07-branchekoden (6 cifre) og dens tekst.
adresse.betegnelseBeliggenhedsadressen på én linje — klar til datavask og BFE-nummer.
adresse.kommune_navnKommune og region som navne (kommune_navn, region_navn), ikke kun koder.
startdato · ophoersdatoHvornår virksomheden startede og eventuelt ophørte.
reklamebeskyttetOm virksomheden har frabedt sig markedsføring.

Hvem bruger det

Når virksomheden og ejendommen hænger sammen

Ejendomsselskaber i en portefølje, lejere i et erhvervsbyggeri, virksomheder på en adresseliste. Se kaldene arbejdet igennem på en rigtig ejendom.

Spørgsmål

Ofte stillede spørgsmål

Ikke i dag. Opslag sker på det ottecifrede CVR-nummer — det står på fakturaer og på virk.dk. Det gælder både REST-API’et og CVR-værktøjet i MCP-serveren. Har I kun navne, må CVR-numrene findes først.

I tre kald med samme nøgle: /v1/cvr/:cvr giver beliggenhedsadressen, /v1/datavask/adgangsadresser gør den til en DAR-adresse med BFE-nummer, og /v1/bbr/ejendom/:bfe og /v1/vurdering/:bfe giver bygningen og vurderingen. Datavasken i midten er nødvendig, fordi CVR’s adressetekst ikke altid svarer præcist til DAR: et husnummer eller en stavemåde kan afvige, og så siger svaret, hvor sikker koblingen er.

Navn, CVR-nummer, status, virksomhedsform, branche (DB07-kode og tekst), beliggenhedsadressen med kommune- og regionsnavn, start- og ophørsdato og reklamebeskyttelse. Vi samler dem fra Datafordelerens CVR-entiteter, så I ikke selv skal koble CVR_Virksomhed, CVR_Navn, CVR_Adressering og CVR_Branche.

Vi bruger aldrig CVR’s personentitet — kun selve virksomhedsposten. For en enkeltmandsvirksomhed kan navn og adresse dog være ejerens personoplysninger, og derfor følger reklamebeskyttet med, så I kan respektere det.

CVR har mange koder for en virksomheds livsforløb. Vi samler dem til et lille ordforråd — aktiv, ophørt, underkonkurs, undertvangsopløsning, tvangsopløst og et par sjældnere — så en leverandør- eller kundeliste kan filtreres på ét felt. Alle former for opløsning og sletning bliver til ophørt; en kode, vi ikke kender, kommer igennem uændret med små bogstaver.

Ét opslag er ét kald, og kæden til ejendommen er tre. Free-planen har 5.000 kald om måneden, Starter 100.000 — samme kvote og nøgle som adresser, BBR og vurdering.

Se også

Begreber og guides

CVR-API

Slå den første virksomhed op i dag

Opret en gratis konto, og lav en API-nøgle. Den samme nøgle går fra CVR-nummeret til adressen og ejendommen bag den.

Gratis op til 5.000 kald/md · intet kreditkort · data fra Erhvervsstyrelsens CVR, underlagt CVR-loven