# Søg efter en adresse

`GET /v1/adresse/search` · Adresser (DAR)

Autocomplete over alle danske adgangsadresser: fritekst ind, rangerede adresser ud med UUID, BFE-nummer og WGS84-punkt.

Søgningen kører mod et lokalt indeks over DAR (Danmarks Adresseregister), fordi Datafordelers eget DAR-endpoint kun kan slå op på id. Præfiks-match rangeres først, derefter stavefejlstolerante match efter lighed, så både `rådhuspladsen 1` og `radhuspladsen` finder Rådhuspladsen 1. Æ, ø og å matcher også skrevet som `ae`, `oe` og `aa`.

Hvert hit er en adgangsadresse (husnummer) uden etage og dør — enhederne med etage og dør finder du via [`/v1/adresser/autocomplete`](https://grundfast.dk/docs/api/adresser-autocomplete). `bfe_nummer` er BFE-nummeret på det jordstykke, adgangspunktet ligger på, så du kan gå direkte videre til [BBR](https://grundfast.dk/docs/api/bbr-ejendom) eller [Matriklen](https://grundfast.dk/docs/api/matrikel-ejendom) uden et ekstra opslag.

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

**Afregning:** Ét kald pr. forespørgsel — også pr. tastetryk, hvis du kalder ved hvert tryk.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `q` | query | string | ja | Fritekst, mindst 2 tegn efter trim. Tekst ud over 128 tegn ignoreres. |
| `per_side` | query | integer | nej | Antal hits. Værdier over 20 sænkes til 20; en tom, ikke-numerisk eller ikke-positiv værdi giver standarden. |

## Eksempel

```bash
curl -G "https://api.grundfast.dk/v1/adresse/search" \
  --data-urlencode "q=rådhuspladsen 1, 1550" \
  --data-urlencode "per_side=8" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "results": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 }
    },
    {
      "betegnelse": "Rådhuspladsen 2, 1550 København V",
      "adgangsadresse_id": "39ece5fb-ee06-0ee2-e044-0003ba298018",
      "bfe_nummer": 6033587,
      "vejnavn": "Rådhuspladsen",
      "husnr": "2",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5677412, "lat": 55.676827 }
    }
  ]
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `results[].adgangsadresse_id` | string (UUID) | DAR-husnummerets UUID — en stabil nøgle, du kan gemme og slå op med [`/v1/adresse/:uuid`](https://grundfast.dk/docs/api/adresse). |
| `results[].betegnelse` | string | Hele adresselinjen, fx "Rådhuspladsen 1, 1550 København V". |
| `results[].bfe_nummer` | integer \| null | BFE på det jordstykke, der dækker adgangspunktet. `null` kun når intet jordstykke dækker punktet. |
| `results[].kommunekode` | string \| null | Firecifret kommunekode som streng, fx `"0101"`. |
| `results[].koordinat` | { lon, lat } \| null | Adgangspunktet i WGS84. |

## 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 | Adressesøgningen er ikke slået til, eller indekset er endnu ikke indlæst i dette miljø. |