# Optællinger pr. postnummer

`GET /v1/stats/postnumre` · Åbne endpoints

Antallet af adresser og stående bygninger i hvert postnummer, uden nøgle.

Ét element pr. postnummer, sorteret efter postnummer. `navn` er postdistriktets navn, som adresseregistret staver det. Bygninger tælles efter den adresse, de har i BBR, så et postnummer uden adresser kan godt have bygninger.

Jordstykker er ikke med her: matriklen knytter dem til kommuner, ikke postnumre. Brug [Optællinger pr. kommune](https://grundfast.dk/docs/api/stats-kommuner) til dem.

**Godkendelse:** Ingen — åbent endpoint

**Afregning:** Gratis og uden nøgle; begrænset til 60 kald i minuttet pr. IP-adresse.

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/stats/postnumre"
```

## Svar (200)

```json
{
  "opdateret": "2026-10-05",
  "antal": 1089,
  "postnumre": [
    {
      "postnr": "1050",
      "navn": "København K",
      "adresser": 39,
      "bygninger": 24
    },
    {
      "postnr": "2300",
      "navn": "København S",
      "adresser": 21193,
      "bygninger": 22647
    }
  ],
  "meta": {
    "kilde": "Grundfast (DAR-indeks, Matriklen jordstykker og BBR-bygningsindeks, lokalt)",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal` | integer | Antal postnumre i listen. |
| `postnumre[]` | object[] | `{ postnr, navn, adresser, bygninger }` for hvert postnummer. |

## Fejl

| Status | Betydning |
| --- | --- |
| 429 | Mere end 60 kald i minuttet fra samme IP-adresse. Se `Retry-After`. |