Spring til indhold

Grundfast

Slå en virksomhed op

Én virksomhed ud fra dens CVR-nummer: navn, status, virksomhedsform, branche og beliggenhedsadresse med kommune og region.

GET/v1/cvr/{cvr}

Opslaget går live mod CVR hos Datafordeler og samler det, der dér ligger som separate entiteter: navn, beliggenhedsadresse, hovedbranche og virksomhedsform. Adressen har kommune- og regionsnavn slået op ud fra kommunekoden, så du ikke selv skal oversætte dem.

status er normaliseret til små bogstaver, fx aktiv, ophørt eller underkonkurs. Vil du kun have aktive virksomheder, så filtrér på status === "aktiv". Er CVR nede, og findes der en cachet kopi, svarer endpointet med den og sætter headeren X-Grundfast-Stale: true.

For en enkeltmandsvirksomhed er navn og beliggenhedsadresse ofte ejerens personoplysninger. Grundfast henter aldrig CVR’s personregister, men du skal selv have et lovligt grundlag for at behandle oplysningerne, og reklamebeskyttet bør respekteres, før de bruges til markedsføring.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald.

Eksempel

curl "https://api.grundfast.dk/v1/cvr/20213094" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet200
{
  "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
  },
  "meta": {
    "kilde": "Erhvervsstyrelsen CVR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

cvrstringstipåkrævet
CVR-nummeret — præcis 8 cifre.Eksempel: 20213094

Felter i svaret

virksomhed.statusstring | null
Livscyklus i små bogstaver: aktiv, ophørt, underkonkurs, undertvangsopløsning m.fl.
virksomhed.adresseobject
Beliggenhedsadressen med kommune_navn, regionskode og region_navn afledt af kommunekoden — CVR har selv ingen regionskode.
virksomhed.branche{ kode, tekst } | null
Hovedbranchen som DB07-kode og dansk tekst.
virksomhed.ophoersdatostring | null
ISO-dato for ophør. null så længe virksomheden er aktiv.
virksomhed.reklamebeskyttetboolean | null
true når virksomheden har frabedt sig markedsføring via Reklamebeskyttelsen. null betyder ukendt — ikke "ikke beskyttet".
virksomhed.telefonstring | null
Registreret telefonnummer. Udfyldes kun, når kontaktfelterne er slået til, og virksomheden positivt er registreret som ikke reklamebeskyttet; ellers null. Det samme gælder email.
virksomhed.hjemmesidestring | null
Altid null: CVR registrerer ingen hjemmeside. Feltet findes for kompatibilitet.

Statuskoder

StatusBetydning
200Svaret er leveret.
400CVR-nummeret er ikke præcis 8 cifre.
401Nøglen mangler eller er ugyldig.
404Der findes ingen virksomhed med det CVR-nummer.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Datafordeler svarede ikke, og der fandtes ingen cachet kopi.
503CVR-kilden er ikke konfigureret i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Demoen svarer altid med den samme rigtige virksomhed, LAGKAGEHUSET A/S (CVR 20213094), i præcis samme form. CVR-nummeret i formularen bruges ikke.

GET /v1/demo/cvr

Bruges ofte sammen med

Læs mere om CVR, og hvad data kan bruges til, på produktsiden.