Spring til indhold

Grundfast

Søg efter en virksomhed

Fritekstsøgning på virksomhedsnavn, der returnerer korte resuméer med CVR-nummer, status, form og kommune.

GET/v1/cvr/search

Datafordelers CVR-tjeneste kan kun slå op på præcise værdier, så navnesøgningen kører mod et lokalt indeks over virksomhedsnavne. Præfiks-match rangeres først, derefter stavefejlstolerante match efter lighed. Æ, ø og å matcher også skrevet som ae, oe og aa.

Hvert hit er et resumé fra indekset, ikke hele virksomheden. Hent detaljerne — adresse, branche, reklamebeskyttelse — med /v1/cvr/:cvr på hittets cvr_nummer.

Navnesøgningen er ikke tilgængelig i alle miljøer. Hvor den ikke er slået til, svarer den 503 — slå virksomheden op på CVR-nummer med /v1/cvr/:cvr i stedet.
Et hit på en enkeltmandsvirksomhed kan være ejerens personoplysninger. Du skal selv have et lovligt grundlag for at behandle dem.

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 pr. forespørgsel.

Eksempel

curl -G "https://api.grundfast.dk/v1/cvr/search" \
  --data-urlencode "q=novo nordisk" \
  --data-urlencode "limit=10" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "results": [
    {
      "cvr_nummer": 24256790,
      "navn": "NOVO NORDISK A/S",
      "status": "aktiv",
      "virksomhedsform": "Aktieselskab",
      "kommune": "Gladsaxe"
    }
  ],
  "count": 10,
  "query": "novo nordisk"
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

qstringquerypåkrævet
Virksomhedsnavn eller en del af det, mindst 2 tegn efter trim.Eksempel: novo nordisk
limitintegerqueryvalgfri
Antal hits, højst 20. per_side accepteres som alias og vinder, hvis begge er sat. En tom eller ikke-positiv værdi giver standarden.Standard:10Eksempel: 10

Felter i svaret

results[].cvr_nummerinteger
CVR-nummeret som tal — nøglen til det fulde opslag.
results[].navnstring
Det navn, der matchede.
results[].statusstring | null
Livscyklus i små bogstaver, fx aktiv eller ophørt.
results[].kommunestring | null
Navnet på kommunen, virksomheden ligger i.
countinteger
Antal hits i results. query ekkoer den trimmede søgetekst.

Statuskoder

StatusBetydning
200Svaret er leveret.
400q mangler eller er kortere end 2 tegn.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
503Navnesøgningen er ikke slået til, eller virksomhedsindekset er endnu ikke indlæst i dette miljø.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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/cvr/search?q=novo+nordisk&limit=10

Bruges ofte sammen med

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