# Søg efter en virksomhed

`GET /v1/cvr/search` · CVR

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

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`](https://grundfast.dk/docs/api/cvr) på hittets `cvr_nummer`.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald pr. forespørgsel.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `q` | query | string | ja | Virksomhedsnavn eller en del af det, mindst 2 tegn efter trim. |
| `limit` | query | integer | nej | 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. |

## Eksempel

```bash
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 (200)

```json
{
  "results": [
    {
      "cvr_nummer": 24256790,
      "navn": "NOVO NORDISK A/S",
      "status": "aktiv",
      "virksomhedsform": "Aktieselskab",
      "kommune": "Gladsaxe"
    }
  ],
  "count": 10,
  "query": "novo nordisk"
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `results[].cvr_nummer` | integer | CVR-nummeret som tal — nøglen til det fulde opslag. |
| `results[].navn` | string | Det navn, der matchede. |
| `results[].status` | string \| null | Livscyklus i små bogstaver, fx `aktiv` eller `ophørt`. |
| `results[].kommune` | string \| null | Navnet på kommunen, virksomheden ligger i. |
| `count` | integer | Antal hits i `results`. `query` ekkoer den trimmede søgetekst. |

## Fejl

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

> 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`](https://grundfast.dk/docs/api/cvr) i stedet.

> Et hit på en enkeltmandsvirksomhed kan være ejerens personoplysninger. Du skal selv have et lovligt grundlag for at behandle dem.