# Adresser på en ejendom

`GET /v1/adgangsadresser/bfe/:bfe` · DAWA-kompatibel

Alle adgangsadresser på et BFE-nummer, sorteret efter husnummer.

Erstatter DAWA’s `/adgangsadresser?bfenummer=`. Brug det, når du har et BFE-nummer og skal vise en adresse — fx fordi BBR-ejendommen ikke har en enhedsadresse. Svaret er et objekt `{ bfe_nummer, antal, truncated, adresser }` i stedet for et bart array.

Adresserne sorteres numerisk efter husnummer, så 23 kommer før 103. Et BFE, der ikke er dækket af adresseindekset, giver `200` med `antal: 0` — ikke `404`. Der returneres højst 200 adresser; `truncated` er `true`, hvis der er flere.

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

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `bfe` | path | integer | ja | BFE-nummeret (Bestemt Fast Ejendom). |
| `srid` | query | string | nej | Når den er sat, får hver adresse `koordinater` i det system: `[lon, lat]` for `4326`, `[x, y]` i meter for `25832`. |
| `format` | query | string | nej | `geojson` giver en FeatureCollection med ét punkt pr. adresse i stedet for JSON-objektet. |

## Eksempel

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

## Svar (200)

```json
{
  "bfe_nummer": 6033528,
  "antal": 8,
  "truncated": false,
  "adresser": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 }
    },
    {
      "betegnelse": "Bag Rådhuset 2, 1550 København V",
      "adgangsadresse_id": "7973ccc7-4a44-4a66-8619-9c5de5e47a12",
      "bfe_nummer": 6033528,
      "vejnavn": "Bag Rådhuset",
      "husnr": "2",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5710209, "lat": 55.6749032 }
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal` | integer | Antal adresser i `adresser`. `0` betyder, at BFE’et ikke har adresser i indekset endnu. |
| `truncated` | boolean | `true` når ejendommen har flere end de 200 adresser, der returneres. |
| `adresser[]` | object[] | Samme felter som et hit fra [`/v1/adresse/search`](https://grundfast.dk/docs/api/adresse-search): UUID, betegnelse, vejnavn, husnummer, postnummer, kommunekode og koordinat. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | BFE-nummeret er ikke et positivt heltal inden for gyldigt interval. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 503 | Adresseindekset er ikke slået til eller endnu ikke indlæst i dette miljø. |