# Hent ejerlav

`GET /v1/ejerlav` · DAWA-kompatibel

Registret over ejerlav (matrikulære distrikter), side for side og sorteret efter kode.

Erstatter DAWA’s `/ejerlav` med samme `side`/`per_side`. Hvert ejerlav er `{ kode, navn }`, og svaret er `{ antal, total, ejerlav, meta }` i stedet for et bart array.

Registret ligger i Grundfast selv og afhænger ikke af Datafordeler, så kaldet svarer også, når Datafordeler er nede.

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

**Afregning:** Ét kald pr. side.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `per_side` | query | integer | nej | Antal ejerlav pr. side, højst 100. |
| `side` | query | integer | nej | Sidenummer, startende ved 1. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/ejerlav?per_side=100" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "antal": 5,
  "total": 9033,
  "ejerlav": [
    { "kode": 10051, "navn": "Frederiksberg" },
    { "kode": 10151, "navn": "Gentofte" },
    { "kode": 10251, "navn": "Buddinge" },
    { "kode": 10252, "navn": "Gladsaxe" },
    { "kode": 10352, "navn": "Hellerup" }
  ],
  "meta": {
    "kilde": "Datafordeler Matriklen (ejerlav) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `ejerlav[].kode` | integer | Ejerlavskoden — den du bruger som `ejerlavkode` på [`/v1/jordstykker`](https://grundfast.dk/docs/api/jordstykker). |
| `ejerlav[].navn` | string \| null | Ejerlavets navn, fx "Vestervold Kvarter, København". |
| `total` | integer | Antal ejerlav i hele registret. |

## Fejl

| Status | Betydning |
| --- | --- |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |