# Autocomplete på ejerlav

`GET /v1/ejerlav/autocomplete` · DAWA-kompatibel

Ejerlav ud fra starten af koden eller en del af navnet.

Erstatter DAWA’s `/ejerlav/autocomplete`. Består `q` kun af cifre, matches starten af koden, og hittene sorteres efter kode. Ellers matches hvor som helst i navnet — med tolerance for `oe`/`aa` i stedet for ø/å — og de korteste navne kommer først. Der returneres højst 20 hits.

**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 | Starten af en ejerlavskode eller en del af ejerlavsnavnet. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/ejerlav/autocomplete?q=kastrup" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "antal": 19,
  "total": 9033,
  "ejerlav": [
    { "kode": 1430153, "navn": "Kastrup, Gram" },
    { "kode": 280254, "navn": "Næs By, Kastrup" },
    { "kode": 280251, "navn": "Barmose, Kastrup" }
  ],
  "meta": {
    "kilde": "Datafordeler Matriklen (ejerlav) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal` | integer | Antal hits, højst 20. |
| `ejerlav[]` | object[] | Højst 20 hits som `{ kode, navn }`. |
| `total` | integer | Antal ejerlav i hele registret — ikke antallet af hits. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | `q` mangler eller er tom. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |