# Hent alle postnumre

`GET /v1/postnumre` · DAWA-kompatibel

Alle danske postnumre med distriktsnavn i ét svar.

Erstatter DAWA’s `/postnumre`. Listen udledes af adresserne i DAR og returneres samlet, sorteret efter nummer — der er ingen sideinddeling. Svaret er `{ antal, total, postnumre, meta }` i stedet for et bart array, og hvert postnummer er `{ nr, navn, stormodtager }`.

Stormodtager-postnumre er udfaset og er som standard ikke med, ligesom i DAWA. Med `stormodtagere=true` kommer de historiske koder med, markeret `stormodtager: true`.

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

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `stormodtagere` | query | boolean | nej | Tag de historiske stormodtager-postnumre med. `true`, `1` eller en tom værdi slår det til. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/postnumre" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "antal": 1089,
  "total": 1089,
  "postnumre": [
    { "nr": "1050", "navn": "København K", "stormodtager": false },
    { "nr": "1051", "navn": "København K", "stormodtager": false },
    { "nr": "1052", "navn": "København K", "stormodtager": false }
  ],
  "meta": {
    "kilde": "Datafordeler DAR (postnumre) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `postnumre[].nr` | string | Firecifret postnummer som streng, fx `"8000"`. |
| `postnumre[].navn` | string \| null | Distriktsnavnet, fx "Aarhus C". |
| `postnumre[].stormodtager` | boolean | `true` kun for de historiske stormodtager-koder, du har bedt om. |

## Fejl

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