---
title: "Nearest access address for each of a list of points (one unit per distinct coordinate answered)"
method: POST
path: "/v1/adgangsadresser/reverse:batch"
---

# Nearest access address for each of a list of points (one unit per distinct coordinate answered)

`POST /v1/adgangsadresser/reverse:batch`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/adgangsadresser/reverse:batch`
- Auth: HTTP bearer

Body `{ punkter: [{ lon, lat, id? }], radius? }` (WGS84; radius in metres, 1–1000, default 200). Each distinct coordinate (rounded to 1e-6°) is looked up and billed once, and its answer goes to EVERY `id` sent at it; only a row repeating both coordinate and `id` is dropped. Every point is validated before any lookup: one point outside Denmark is a 400 for the call, counted as one call against the quota. Each answered row carries the ONE nearest adgangsadresse; a point with none inside `radius` is a 404 in `errors` and is not billed. `id` is echoed on both. Served from the local DAR index. Ids per call follow the plan: 50 on Pro, 100 on Scale, 150 on Enterprise — a longer list is a 402 (or a 400 past 150) that names the limit; send it as a job (POST /v1/jobs) instead.

## Request body

- AdgangsadresseReverseBatchInput
  - `punkter` object[], required
    - `lon` number, required
    - `lat` number, required
    - `id` string
  - `radius` integer

## Response `200`

OK

- AdgangsadresseReverseBatchResponse
  - `results` object[], required
    - `id` string
    - `punkt` object, required
      - `lon` number, required
      - `lat` number, required
    - `adresse` object, required
      - `betegnelse` string, required
      - `adgangsadresse_id` string, required
      - `bfe_nummer` number, nullable, required
      - `vejnavn` string, nullable, required
      - `husnr` string, nullable, required
      - `postnr` string, nullable, required
      - `postnrnavn` string, nullable, required
      - `kommunekode` string, nullable, required
      - `koordinat` object, nullable, required
        - `lon` number, required
        - `lat` number, required
      - `afstand_m` number, required
  - `errors` object[], required: Points with no access address inside `radius` (404). Not billed.
    - `id` string
    - `punkt` object, required
      - `lon` number, required
      - `lat` number, required
    - `error` string, required
    - `status` number, required
  - `requested` number, required
  - `succeeded` number, required
  - `failed` number, required
  - `radius` number, required
  - `meta` object, required
    - `kilde` string, required
    - `grundfast_version` string, required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Error
- `503`: Error

---

[API](https://skmtc.dev/grundfast/apis/grundfast-api.md) · [All operations](https://skmtc.dev/grundfast/apis/grundfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grundfast/apis/grundfast-api/revisions/ccef6e299bb5?raw)