---
title: "Retrieve a location"
method: GET
path: "/locations"
tags: ["Locations"]
---

# Retrieve a location

`GET /locations`

Retrieve a location name and the childs of a given location <neighborhood, city, state>.  If no parameter provided, the states from the country registered in your account will be returned.

## Query parameters

- `query` string

## Response `200`

Successful location list request

- LocationList
  - `name` string
  - `full_name` string
  - `type` string
  - `localities` Locality[]
    - `name` string
    - `full_name` string
    - `type` string

## Other responses

- `401` — API key is missing or invalid, or a restricted country was selected
- `404` — No location was found with the provided query

---

[API](https://skmtc.dev/easybroker/apis/easybroker-api.md) · [All operations](https://skmtc.dev/easybroker/apis/easybroker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/easybroker/easybroker-api/revisions/1aea2ecce635/schema)