Spring til indhold

Grundfast

Virksomhedsændringer (CVR)

Oprettede, ændrede og ophørte virksomheder fra den ugentlige CVR-opdatering, for en liste CVR-numre eller en kommune.

GET/v1/overvaagning/cvr/haendelser

Feedet er det samme, som cvr.*-webhooks leveres fra. Hver uge sammenlignes hele CVR med den kopi, Grundfast serverer, og det der flyttede sig på et felt vi udstiller (navn, status, ophørsdato, virksomhedsform, adresse, kommune og hovedbranche), skrives som en ændring i stigende sekvens-orden. Ændringer gemmes i 35 dage.

cvr.ophoert er overgangen fra aktiv til ophørt (status ophørt eller tvangsopløst, eller en ophørsdato der dukker op) — så en overvågning af en portefølje ikke kræver at slå alle firmaerne op hver nat. Angiv mindst én af cvr_nummer og kommunekode; en kommune matcher også virksomheder, der er flyttet ud af den.

Kopien genindlæses ugentligt, så en ændring dukker op op til ca. en uge efter, CVR registrerede den. meta.feed siger hvornår seneste opdatering lykkedes, og forsinket er true hvis den er udeblevet.

Godkendelse · API-nøgle eller session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Kræver Pro-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Ikke målt.

Eksempel

curl "https://api.grundfast.dk/v1/overvaagning/cvr/haendelser?cvr_nummer=12345678&kommunekode=0101" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "antal": 1,
  "haendelser": [
    {
      "sekvens": 9120,
      "haendelse": "cvr.ophoert",
      "cvr_nummer": 12345678,
      "navn": "Eksempel ApS",
      "kommunekode": "0101",
      "status": "ophørt",
      "aendrede_felter": ["status", "ophoersdato"],
      "foer": {
        "navn": "Eksempel ApS",
        "status": "aktiv",
        "ophoersdato": null,
        "virksomhedsform": "Anpartsselskab",
        "adresse": "Kalvebod Brygge 59, 1560 København V",
        "kommunekode": "0101",
        "kommune": "København",
        "branche": { "kode": "620100", "tekst": "Computerprogrammering" }
      },
      "efter": {
        "navn": "Eksempel ApS",
        "status": "ophørt",
        "ophoersdato": "2026-09-30",
        "virksomhedsform": "Anpartsselskab",
        "adresse": "Kalvebod Brygge 59, 1560 København V",
        "kommunekode": "0101",
        "kommune": "København",
        "branche": { "kode": "620100", "tekst": "Computerprogrammering" }
      },
      "cvr_udtraek": "CVR_20261003",
      "registreret": "2026-10-04T03:12:40.118Z"
    }
  ],
  "naeste_efter": 9120,
  "flere": false,
  "meta": {
    "kilde": "Det Centrale Virksomhedsregister (CVR) — ugentligt totaludtræk, via Grundfast",
    "grundfast_version": "1.0.0",
    "feed": {
      "daekket_fra": "2026-09-06T03:10:11.402Z",
      "senest_opdateret": "2026-10-04T03:14:02.551Z",
      "seneste_udtraek": "CVR_20261003",
      "opdateringsinterval_dage": 7,
      "opbevaring_dage": 35,
      "forsinket": false
    }
  }
}

Parametre

cvr_nummerstringqueryvalgfri
Op til 100 CVR-numre (8 cifre), kommaseparerede.Eksempel: 12345678
kommunekodestringqueryvalgfri
Op til 10 kommunekoder, kommaseparerede. Tre cifre udfyldes med 0 foran.Eksempel: 0101
haendelsestringqueryvalgfri
Kun én slags ændring.Værdier:cvr.oprettetcvr.aendretcvr.ophoert
efterintegerqueryvalgfri
Returnér kun ændringer med sekvens større end dette tal.Standard:0
antalintegerqueryvalgfri
Ændringer pr. side, 1-100.Standard:100

Felter i svaret

haendelser[].sekvensinteger
Globalt, stigende løbenummer. Brug det som markør og til at fjerne dubletter.
haendelser[].aendrede_felterstring[]
Hvilke af navn, status, ophoersdato, virksomhedsform, adresse, kommunekode, kommune og branche der ændrede sig. Tom for cvr.oprettet.
haendelser[].foerobject | null
Virksomheden før ændringen; null for cvr.oprettet.
haendelser[].efterobject
Virksomheden efter ændringen.
naeste_efterinteger
Send som efter i næste kald, så du hverken springer over eller gentager.
meta.feed.senest_opdateretstring | null
Seneste vellykkede ugentlige CVR-opdatering. Et tomt svar betyder kun "ingen ændringer" frem til dette tidspunkt.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Intet område angivet, et ugyldigt CVR-nummer eller en ugyldig kommunekode, eller for mange værdier.
401Hverken en gyldig nøgle eller en session.
402Planen er under Pro.
403Nøglen er en admin-nøgle, eller kontoen er suspenderet.
429Burst-grænsen pr. minut er nået.

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

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/overvaagning/cvr/haendelser?cvr_nummer=12345678&kommunekode=0101

Bruges ofte sammen med