# Vask mange adresser

`POST /v1/datavask/adgangsadresser:batch` · DAWA-kompatibel

Vask op til 50 adressestrenge i ét kald, med kategori og kandidater for hver.

Batch-udgaven af [`/v1/datavask/adgangsadresser`](https://grundfast.dk/docs/api/datavask) til fx en kundeliste. Hver streng vaskes præcis som i enkeltkaldet, og resultaterne kommer i samme rækkefølge som input, efter at dubletter er fjernet.

Et input uden match er ikke en fejl, men et resultat med `kategori: "C"` og `antal: 0`. Derfor er `succeeded` altid lig med `requested`, og der er ingen fejlliste. Kun en ugyldig body giver `400`.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Pro-planen

**Afregning:** Én enhed pr. unik adressestreng.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `betegnelser` | body | string[] | ja | 1–50 adressestrenge på hver 2–128 tegn efter trim. |

## Request-body

```json
{
  "betegnelser": [
    "Rådhuspladsen 1, 1550 København V",
    "Store Torv 1, 8000 Aarhus"
  ]
}
```

## Eksempel

```bash
curl -X POST "https://api.grundfast.dk/v1/datavask/adgangsadresser:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"betegnelser":["Rådhuspladsen 1, 1550 København V","Store Torv 1, 8000 Aarhus"]}'
```

## Svar (200)

```json
{
  "results": [
    {
      "input": "Rådhuspladsen 1, 1550 København V",
      "kategori": "A",
      "antal": 10,
      "resultater": [
        {
          "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 },
          "lighed": 1
        }
      ]
    },
    {
      "input": "Store Torv 1, 8000 Aarhus",
      "kategori": "B",
      "antal": 10,
      "resultater": [
        {
          "betegnelse": "Store Torv 1, 8000 Aarhus C",
          "adgangsadresse_id": "0a3f5096-fac9-32b8-e044-0003ba298018",
          "bfe_nummer": 5621995,
          "vejnavn": "Store Torv",
          "husnr": "1",
          "postnr": "8000",
          "postnrnavn": "Aarhus C",
          "kommunekode": "0751",
          "koordinat": { "lon": 10.209303, "lat": 56.1569335 },
          "lighed": 0.923
        }
      ]
    }
  ],
  "requested": 2,
  "succeeded": 2,
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `results[].input` | string | Den trimmede inputstreng, så du kan parre resultatet med din egen række. |
| `results[].kategori` | 'A' \| 'B' \| 'C' | Samme kategori som i enkeltkaldet. Læs den sammen med `results[].antal`. |
| `results[].resultater` | object[] | Op til 10 kandidater med `lighed`, sorteret faldende. |
| `requested` | integer | Antal unikke strenge efter dubletfjernelse — og antal fakturerede enheder. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Body er ikke `{ betegnelser: string[] }` med 1–50 strenge på 2–128 tegn. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Planen er under Pro. |
| 429 | Burst-grænsen eller månedskvoten er nået — kvoten tjekkes mod hele batchens antal enheder. |
| 503 | Adresseindekset er ikke slået til eller endnu ikke indlæst i dette miljø. |