---
title: "List Nearby Pricing Locations"
method: GET
path: "/pricing_locations/nearby"
tags: ["Pricing Locations"]
---

# List Nearby Pricing Locations

`GET /pricing_locations/nearby`

Get a list of pricing locations near the provided latitude/longitude
or gs_entity_id. User must provide either latitude and longitude or a
gs_entity_id, but not both.

## Query parameters

- `api_key` string, nullable — API key for authentication (query)
- `limit` integer
- `latitude` number, nullable — The latitude of the location to search
- `longitude` number, nullable — The longitude of the location to search
- `gs_entity_id` string, nullable — The GS entity ID of the location to search

## Headers

- `x-api-key` string, nullable — API key for authentication (header)

## Response `200`

Successful Response

- NearbyPricingLocationItem[]
  - `gs_entity_id` string, required
  - `location` string, required
  - `market_id` string, required
  - `distance_in_miles` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/gridstatus/apis/grid-status-api.md) · [All operations](https://skmtc.net/gridstatus/apis/grid-status-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gridstatus/grid-status-api/versions/fa1f094be2d4/schema)