# Hent en adresses historik

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

Registreringshistorikken for én DAR-adresse: hver version med registrerings- og virkningsperiode, nyeste først.

DAR er bitemporalt: hver version har en registreringsperiode (hvornår registret skrev den) og en virkningsperiode (hvornår den gjaldt i virkeligheden). Endpointet henter alle versioner af den DAR-entitet, UUID’en peger på, direkte fra Datafordeler.

`niveau` fortæller, hvilken entitet tidslinjen gælder: `adresse` (en enhedsadresse — versionerne bærer `etage` og `doer`) eller `husnummer` (en adgangsadresse — versionerne bærer `husnr`). Tidslinjen viser entitetens egne felter, ikke en fuldt sammensat adresse med vejnavn og postnummer pr. version; brug [`asOf`](https://grundfast.dk/docs/api/adresse) til det.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Scale-planen

**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. |

## Eksempel

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

## Svar (200)

```json
{
  "type": "adresse_historik",
  "id": "0a3f507a-ec01-32b8-e044-0003ba298018",
  "niveau": "husnummer",
  "versioner": [
    {
      "registrering_fra": "2020-01-01T00:00:00.000Z",
      "registrering_til": null,
      "virkning_fra": "2020-01-01T00:00:00.000Z",
      "virkning_til": null,
      "status": "3",
      "husnr": "1",
      "etage": null,
      "doer": null
    },
    {
      "registrering_fra": "2018-01-01T00:00:00.000Z",
      "registrering_til": "2020-01-01T00:00:00.000Z",
      "virkning_fra": "2018-01-01T00:00:00.000Z",
      "virkning_til": "2020-01-01T00:00:00.000Z",
      "status": "3",
      "husnr": "1",
      "etage": null,
      "doer": null
    }
  ],
  "afkortet": false,
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `niveau` | 'adresse' \| 'husnummer' | Hvilken DAR-entitet tidslinjen gælder for. |
| `versioner[].status` | string \| null | DAR-statuskoden for versionen, fx `"3"` (gældende). |
| `versioner[].registrering_fra` | string \| null | Start på registreringsperioden. `registrering_til` er `null` for den version, der stadig er registreret. |
| `versioner[].virkning_fra` | string \| null | Start på virkningsperioden. `virkning_til` er `null`, mens versionen stadig gælder. |
| `afkortet` | boolean | `true` når tidslinjen ramte loftet for antal versioner, og de ældste er udeladt. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | UUID’en har ikke formatet 8-4-4-4-12. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Planen er under Scale. |
| 404 | UUID’en svarer hverken til en enhedsadresse eller en adgangsadresse i DAR. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Datafordeler svarede ikke. Historikken hentes altid live og caches ikke. |
| 503 | DAR-kilden er ikke konfigureret i dette miljø. |