# Slå en adresse op

`GET /v1/adresse/:uuid` · Adresser (DAR)

Én DAR-adresse ud fra dens UUID, struktureret i vejnavn, husnummer, etage, dør og postnummer med et WGS84-punkt.

Opslaget går live mod DAR hos Datafordeler. UUID’en kan være en enhedsadresse (med etage og dør) eller en adgangsadresse (husnummer) — fx `adgangsadresse_id` fra [søgningen](https://grundfast.dk/docs/api/adresse-search) eller `adresse.id` på en enhed i [BBR-ejendommen](https://grundfast.dk/docs/api/bbr-ejendom). For en adgangsadresse er `etage` og `doer` `null`.

Kun gældende adresser returneres. Med `asOf` får du adressen, som den var registreret på en given dato; datoen ekkoes i `meta.as_of`. Er DAR nede, og findes der en cachet kopi, svarer endpointet med den og sætter headeren `X-Grundfast-Stale: true`.

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

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `uuid` | path | string (UUID) | ja | DAR-id (`id_lokalId`) for en enhedsadresse eller en adgangsadresse. |
| `asOf` | query | string (ISO 8601) | nej | Hent adressen, som den var registreret på en dato, fx `2020-01-01`. Skal ligge mellem 1990-01-01 og i dag. Kræver Scale-planen; uden parameteren er kaldet åbent for alle planer. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/adresse/0a3f50c2-09e9-32b8-e044-0003ba298018" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "adresse": {
    "id": "0a3f50c2-09e9-32b8-e044-0003ba298018",
    "betegnelse": "Solbakkevej 70, 8600 Silkeborg",
    "vejnavn": "Solbakkevej",
    "husnr": "70",
    "etage": "",
    "doer": "",
    "postnr": "8600",
    "postnrnavn": "Silkeborg",
    "kommunekode": "0740",
    "koordinat": { "lon": 9.532961, "lat": 56.1578452 }
  },
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `adresse.betegnelse` | string \| null | Hele adresselinjen. Etage skrives med punktum, fx "2. tv". |
| `adresse.etage` | string \| null | Etagebetegnelse, fx `st`, `1` eller `kl`. `null` for en adgangsadresse. |
| `adresse.doer` | string \| null | Dørbetegnelse, fx `tv`, `th` eller `mf`. `null` for en adgangsadresse. |
| `adresse.kommunekode` | string \| null | Er i øjeblikket altid `null` på dette opslag. Brug [søgningen](https://grundfast.dk/docs/api/adresse-search) eller [jordstykket](https://grundfast.dk/docs/api/jordstykker-reverse), hvis du skal bruge kommunen. |
| `adresse.koordinat` | { lon, lat } \| null | Adressepunktet i WGS84. `null` hvis punktet ikke kunne hentes. |
| `meta.as_of` | string | Kun med når du har sendt `asOf`: det tidspunkt, svaret gælder for. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | UUID’en har ikke formatet 8-4-4-4-12, eller `asOf` er ugyldig, før 1990 eller i fremtiden. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | `asOf` er sendt, men planen er under Scale. |
| 404 | UUID’en svarer ikke til en gældende adresse — eller, med `asOf`, ikke til en adresse på den dato. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Datafordeler svarede ikke, og der fandtes ingen cachet kopi. |
| 503 | DAR-kilden er ikke konfigureret i dette miljø. |