# Din første forespørgsel

Fra en adresse til hele ejendommen: opret en gratis konto, hent en API-nøgle og lav to kald. Det tager under to minutter.

## Prøv uden nøgle

Demo-endpoints under `/v1/demo/*` svarer uden nøgle for et fast emne — rigtige data, fx ejendommen BFE 5651067 — i samme form som de rigtige endpoints. De er begrænset pr. IP-adresse og egner sig til at se svarformen, ikke til produktion.

```bash
curl https://api.grundfast.dk/v1/demo/ejendom
```

Tilsvarende findes blandt andet `/v1/demo/matrikel`, `/v1/demo/adresse`, `/v1/demo/dhm`, `/v1/demo/byggelinjer`, `/v1/demo/vurdering` og `/v1/demo/cvr`.

> **Ikke udvikler?** Vil du bare slå en adresse op — fx terrænkoten, byggeretten eller BBR-oplysningerne — så brug [Værktøjer](https://grundfast.dk/vaerktoejer). De kalder de samme registre og kræver ingen kode. Se også [Uden kode](https://grundfast.dk/docs/uden-kode).

## Fire trin

1. **Opret en konto og en API-nøgle** — Opret en gratis konto i [dashboardet](https://grundfast.dk/dashboard?mode=register) og lav en API-nøgle under Nøgler. Vælg en `gf_test_`-nøgle til udvikling: den rammer de rigtige registre, men faktureres aldrig. Nøglen vises kun én gang. Gem den som miljøvariablen `GRUNDFAST_API_KEY`, så den aldrig står i koden — alle eksempler her læser den derfra.

```bash
export GRUNDFAST_API_KEY="<din gf_test_-nøgle>"
```

2. **Find ejendommen ud fra adressen** — Kald `GET /v1/adresse/search?q=…` med adressen som tekst. Det første resultat har ejendommens **BFE-nummer** (`bfe_nummer` — ejendommens nummer i de offentlige registre) og adressens koordinat.

3. **Hent hele ejendommen i ét kald** — Kald `GET /v1/ejendom/:bfe` med BFE-nummeret. Svaret samler bygninger (BBR), grund og matrikel, vurdering, terræn, lokalplan, byggelinjer og meget mere.

4. **Byg videre** — Læs om [fejl og statuskoder](https://grundfast.dk/docs/fejl) og [rate limits](https://grundfast.dk/docs/rate-limits), før du går i produktion, og skift til en `gf_live_`-nøgle.

## Kaldene

**cURL**

```bash
# 1) Adresse → BFE-nummer
curl -G https://api.grundfast.dk/v1/adresse/search \
  --data-urlencode "q=Solbakkevej 70, 8600 Silkeborg" \
  --data-urlencode "per_side=1" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

# 2) BFE-nummer → hele ejendommen
curl https://api.grundfast.dk/v1/ejendom/5651067 \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

**TypeScript**

```ts
import { GrundfastClient } from '@grundfast/sdk';

// gf_test_ under udvikling, gf_live_ i produktion. Hold nøglen på serveren.
const gf = new GrundfastClient({ apiKey: process.env.GRUNDFAST_API_KEY });

const { results } = await gf.adresseSearch('Solbakkevej 70, 8600 Silkeborg', 1);
const bfe = results[0]?.bfe_nummer;
if (!bfe) throw new Error('Adressen blev ikke fundet');

const ejendom = await gf.ejendomProfil(bfe);
console.log(ejendom.bbr?.hovedbygning_anvendelse, ejendom.bbr?.hovedbygning_opfoerelsesaar);
```

**JavaScript**

```js
const base = 'https://api.grundfast.dk';
const headers = { Authorization: `Bearer ${process.env.GRUNDFAST_API_KEY}` };

async function get(path) {
  const res = await fetch(base + path, { headers });
  const body = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${body.type}: ${body.message}`);
  return body;
}

const q = encodeURIComponent('Solbakkevej 70, 8600 Silkeborg');
const { results } = await get(`/v1/adresse/search?q=${q}&per_side=1`);
const ejendom = await get(`/v1/ejendom/${results[0].bfe_nummer}`);
console.log(ejendom.bbr.hovedbygning_anvendelse, ejendom.bbr.hovedbygning_opfoerelsesaar);
```

**Python**

```py
import os
import requests

base = "https://api.grundfast.dk"
headers = {"Authorization": f"Bearer {os.environ['GRUNDFAST_API_KEY']}"}

hit = requests.get(f"{base}/v1/adresse/search",
                   params={"q": "Solbakkevej 70, 8600 Silkeborg", "per_side": 1},
                   headers=headers, timeout=30).json()["results"][0]

res = requests.get(f"{base}/v1/ejendom/{hit['bfe_nummer']}", headers=headers, timeout=60)
res.raise_for_status()
ejendom = res.json()
print(ejendom["bbr"]["hovedbygning_anvendelse"], ejendom["bbr"]["hovedbygning_opfoerelsesaar"])
```

Uden en gyldig API-nøgle svarer API’et `401`. Alle fejl har samme form — byg logikken på `type`, og vis `message` til brugeren:

```json
{
  "error": "invalid API key",
  "type": "invalid_api_key",
  "code": "api_key_missing",
  "message": "API-nøglen mangler, er ugyldig eller udløbet.",
  "request_id": "b4dba773-9a87-4827-8795-54c548929fb1",
  "doc_url": "https://grundfast.dk/docs/fejl#invalid_api_key"
}
```

> Send nøglen i headeren `Authorization: Bearer …`. Kun hvor en header ikke kan sættes, kan den sendes som `?token=` (se [Godkendelse](https://grundfast.dk/docs/godkendelse#token-parameter)). Alle fejltyper står i [Fejl og statuskoder](https://grundfast.dk/docs/fejl).

## Svaret

Sådan ser svaret fra `/v1/ejendom/5651067` ud — et parcelhus på Solbakkevej 70 i Silkeborg. Svaret er langt; her er et udpluk af de vigtigste blokke.

**Svar · 200 · udpluk**

```json
{
  "bfe_nummer": 5651067,
  "adresse": { "betegnelse": "Solbakkevej 70, 8600 Silkeborg" },
  "bbr": {
    "antal_bygninger": 2,
    "antal_enheder": 1,
    "samlet_boligareal_m2": 95,
    "hovedbygning_opfoerelsesaar": 1958,
    "hovedbygning_anvendelse": "Fritliggende enfamiliehus"
  },
  "parcel": {
    "matrikelnummer": "138o",
    "ejerlavsnavn": "Silkeborg Markjorder",
    "areal_m2": 460
  },
  "vurdering": {
    "seneste": { "aar": 2024, "ejendomsvaerdi_kr": 2596000, "grundvaerdi_kr": 1702000 }
  },
  "terraen": { "terraen_m": 27.94, "overflade_m": 27.94 },
  "plan": {
    "zone": { "status": "byzone" },
    "har_lokalplan": false
  },
  "meta": { "kilde": "Grundfast", "id": "5651067", "id_type": "bfe" }
}
```

1. **Ejendommen og dens adresse.** BFE-nummeret er ejendommens nøgle i alle registre. `:id` kan også være et adresse-id fra DAR (en UUID) — men ikke adresseteksten; den slår du op med `/v1/adresse/search`.
2. **Bygningerne, opsummeret.** Hovedbygningens anvendelse og opførelsesår, antal bygninger og boligareal. Alle bygninger med materialer, varme og etager står på [`/v1/bbr/ejendom/:bfe`](https://grundfast.dk/docs/api/bbr-ejendom).
3. **Grunden.** Matrikelnummer (grundens nummer i Matriklen), ejerlav og areal i m².
4. **Vurdering og terræn.** Seneste offentlige vurdering og terrænkoten i meter over havet (DVR90), målt i `opslagspunkt` inde på grunden — se [terrænkoten for en adresse](https://grundfast.dk/guides/terraenhoejde-for-en-adresse).
5. **Planer.** Zone, lokalplaner og kommuneplanramme. `null` betyder, at registret ikke kunne svare — aldrig "ingen".

Alle felter står på [referencesiden for ejendomsprofilen](https://grundfast.dk/docs/api/ejendom-profil). Hvordan `null`, kodefelter og koordinater skal læses, står i [Svar, null og friskhed](https://grundfast.dk/docs/svar-og-headers).

## Næste skridt

- [Godkendelse og nøgler](https://grundfast.dk/docs/godkendelse) — Forskellen på live og test, og hvordan du tilbagekalder en nøgle.
- [API-reference](https://grundfast.dk/docs/api) — Alle endpoints: matrikel, vurdering, adresser, DHM, byggelinjer og resten.
- [TypeScript-SDK](https://grundfast.dk/docs/sdk) — Typede svar, indbygget retry og afbrydelse med AbortSignal.
- [MCP-server](https://grundfast.dk/docs/mcp) — Lad en AI-agent slå ejendomme op med den samme nøgle.
