Spring til indhold

Grundfast

Hent en adresses historik

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

GET/v1/adresse/{uuid}/historik

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 til det.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Kræver Scale-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Ét kald.

Eksempel

curl "https://api.grundfast.dk/v1/adresse/0a3f507a-ec01-32b8-e044-0003ba298018/historik" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "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"
  }
}

Parametre

uuidstring (UUID)stipåkrævet
DAR-id (id_lokalId) for en enhedsadresse eller en adgangsadresse.Eksempel: 0a3f507a-ec01-32b8-e044-0003ba298018

Felter i svaret

niveau'adresse' | 'husnummer'
Hvilken DAR-entitet tidslinjen gælder for.
versioner[].statusstring | null
DAR-statuskoden for versionen, fx "3" (gældende).
versioner[].registrering_frastring | null
Start på registreringsperioden. registrering_til er null for den version, der stadig er registreret.
versioner[].virkning_frastring | null
Start på virkningsperioden. virkning_til er null, mens versionen stadig gælder.
afkortetboolean
true når tidslinjen ramte loftet for antal versioner, og de ældste er udeladt.

Statuskoder

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

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/adresse/0a3f507a-ec01-32b8-e044-0003ba298018/historik

Bruges ofte sammen med

Læs mere om Adresser (DAR), og hvad data kan bruges til, på produktsiden.