---
title: "GET /api/v1/locations/nearby"
method: GET
path: "/api/v1/locations/nearby"
tags: ["locations"]
---

# GET /api/v1/locations/nearby

`GET /api/v1/locations/nearby`

Return locations within a given radius of a center point.
Results are ordered by distance (closest first), then by id.
Each result includes a computed `distance_km` field.

## Query parameters

- `lat` number, float, required
- `lon` number, float, required
- `page` integer
- `radius_km` number, float, required
- `size` integer

## Response `200`

- PaginatedLocationNearbyList
  - `items` LocationNearby[], required
    - `id` integer, required
    - `osm_brand_logo_url` string, required
    - `distance_km` number, double, required
    - `type` 'OSM' | 'ONLINE', required — * `OSM` - OSM * `ONLINE` - ONLINE
    - `osm_id` integer, nullable
    - `osm_type` union
      - 'NODE' | 'WAY' | 'RELATION' — * `NODE` - NODE * `WAY` - WAY * `RELATION` - RELATION
      - ''
      - unknown
    - `osm_name` string, nullable
    - `osm_display_name` string, nullable
    - `osm_tag_key` string, nullable
    - `osm_tag_value` string, nullable
    - `osm_brand` string, nullable
    - `osm_address_postcode` string, nullable
    - `osm_address_city` string, nullable
    - `osm_address_country` string, nullable
    - `osm_address_country_code` string, nullable
    - `osm_lat` number, double, nullable
    - `osm_lon` number, double, nullable
    - `osm_version` integer, nullable
    - `website_url` string, uri, nullable
    - `price_count` integer
    - `user_count` integer
    - `product_count` integer
    - `proof_count` integer
    - `source` string, nullable
    - `created` string, date-time
    - `updated` string, date-time, required
  - `page` integer, required — Current page number
  - `pages` integer, required — Total number of pages
  - `size` integer, required — Number of items per page
  - `total` integer, required — Total number of items

---

[API](https://skmtc.net/openfoodfacts/apis/open-food-facts-open-prices-rest-api.md) · [All operations](https://skmtc.net/openfoodfacts/apis/open-food-facts-open-prices-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openfoodfacts/open-food-facts-open-prices-rest-api/revisions/2315a270e4e6/schema)