---
title: "Addresses near a point"
method: GET
path: "/v1/addresses/nearby"
---

# Addresses near a point

`GET /v1/addresses/nearby`

## Request

- Base URL: `https://veldora.no`
- URL: `https://veldora.no/v1/addresses/nearby`
- Auth: none declared

Norwegian addresses from Kartverket within a radius (1 to 1000 m) of a coordinate, nearest first, with distance in metres.

Price: 0.005 USDC per successful call. Failed calls (4xx/5xx) are not charged.

## Query parameters

- `lat` number
- `lon` number
- `radius` integer
- `page` integer
- `size` integer

## Headers

- `PAYMENT-SIGNATURE` string

## Response `200`

Data. The PAYMENT-RESPONSE header holds the settlement receipt (base64 JSON).

- object
  - `data` unknown
  - `page` object
  - `meta` object

## Other responses

- `400`: Invalid input. Not charged; no payment is asked for.
- `402`: Payment required. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists what to pay. Sign it with an x402 client and resend the request with the PAYMENT-SIGNATURE header. The body repeats the requirements, plus `error` when a payment was rejected.
- `404`: Not found. Not charged.
- `405`: Method not allowed.
- `409`: The same payment is being processed by another request. Retry with the same header.
- `429`: Rate limited. Not charged. See Retry-After.
- `500`: Internal error. Not charged.
- `502`: A data source answered with an error. Not charged; retry.
- `503`: Upstream data source, facilitator or settlement unavailable. Not charged; retry.

---

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