# Cities

## List Hotspot Cities <a href="#id-7a36d6d4-7b16-4696-989d-4a05e8def762" id="id-7a36d6d4-7b16-4696-989d-4a05e8def762"></a>

List all known hotspot cities with the total hotspot count for each city.

#### Query Parameters

| Name                                                                                                                                                                                                                                                                          | Tags     | Description                            | Example                                                                | Type |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------------------- | ---------------------------------------------------------------------- | ---- |
| [search](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Cities%207dec1e355b1f4c0f8277228be500b310/Query%20Parameters%20ae907ca52d474a9ebfde12729cae41e2/search%20a36f5ba1bc4c44edb73530e0c76b7b17.html) | optional | Term to limit the list of cities with. | Saint                                                                  | text |
| [cursor](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Cities%207dec1e355b1f4c0f8277228be500b310/Query%20Parameters%20ae907ca52d474a9ebfde12729cae41e2/cursor%2015d67517d13842c6ba7f2111a102ba18.html) | optional | Cursor for page to fetch.              | eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ | text |

### Response <a href="#ca9c85d1-96fa-4afb-bb65-0c2564f1ef03" id="ca9c85d1-96fa-4afb-bb65-0c2564f1ef03"></a>

```
{
  "data": [
    {
      "city_id": "aG91c3RvbnRleGFzdW5pdGVkIHN0YXRlcw",
      "hotspot_count": 52,
      "long_city": "Houston",
      "long_country": "United States",
      "long_state": "Texas",
      "short_city": "Houston",
      "short_country": "US",
      "short_state": "TX"
    },
    {
      "city_id": "aG91c3RvbnRleGFzdW5pdGVkIHN0YXRlcw",
      "hotspot_count": 52,
      "long_city": "Houston",
      "long_country": "United States",
      "long_state": "Texas",
      "short_city": "Houston",
      "short_country": "US",
      "short_state": "TX"
    }
  ], 
  "cursor": "eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ"
}
```

## List Hotspots for a City <a href="#id-767ed25d-36fb-41a1-8c98-60b6a3b03575" id="id-767ed25d-36fb-41a1-8c98-60b6a3b03575"></a>

Lists all known hotspots for a given city\_id.

#### Query Parameters

| Name                                                                                                                                                                                                                                                                             | Tags     | Description                                          | Example                                                                | Type |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------- | ---------------------------------------------------------------------- | ---- |
| [city\_id](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Cities%207dec1e355b1f4c0f8277228be500b310/Query%20Parameters%2045344cea37114dfb984eb61ffc281322/city_id%200b3159a21c284d14a7b2530d1b407fe4.html) | required | The id for the city are returned by the cities list. | c2FpbnRlLW1hcmllLWF1eC1jaMOqbmVzZ3JhbmQgZXN0ZnJhbmNl                   | text |
| [cursor](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Cities%207dec1e355b1f4c0f8277228be500b310/Query%20Parameters%2045344cea37114dfb984eb61ffc281322/cursor%20d76fb58198be44b7be632a5c598b192d.html)    | optional | Cursor for page to fetch.                            | eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ | text |

### Response <a href="#id-475d59ba-9b7c-466e-b781-598e47be8b80" id="id-475d59ba-9b7c-466e-b781-598e47be8b80"></a>

```
{
  "data": [
    {
      "address": "11C5PW3fe5RmBV7jvdmBJmjH7FjiZ3URAZ5oUj2V9dVsW83a5wU",
      "block": 403147,
      "block_added": 356922,
      "geocode": {
        "long_city": "Montrose",
        "long_country": "United States",
        "long_state": "New York",
        "long_street": "Dutch Street",
        "short_city": "Montrose",
        "short_country": "US",
        "short_state": "NY",
        "short_street": "Dutch St",
        "city_id": "bW9udHJvc2VuZXcgeW9ya3VuaXRlZCBzdGF0ZXM"
      },
      "lat": 41.24450048207128,
      "lng": -73.93189556758152,
      "location": "8c2a10c020007ff",
      "name": "delightful-onyx-swan",
      "nonce": 1,
      "owner": "142dmsAe4qVmNxdZJuQiFmpSnB9p6wBkAX78MVza1yNrF4t5R6e",
      "score": 0.25,
      "score_update_height": 403138,
      "status": {
        "gps": "no_fix",
        "height": 403025,
        "online": "online"
      }
    },
    {
      "address": "112PSCgC7kXWFnKWrczNL6srYKQpg3VdA9iou6FrQW4C1aot5HPc",
      "block": 403147,
      "block_added": 355849,
      "geocode": {
        "long_city": "Montrose",
        "long_country": "United States",
        "long_state": "New York",
        "long_street": "Sunset Road",
        "short_city": "Montrose",
        "short_country": "US",
        "short_state": "NY",
        "short_street": "Sunset Rd",
        "city_id": "bW9udHJvc2VuZXcgeW9ya3VuaXRlZCBzdGF0ZXM"
      },
      "lat": 41.24464436633493,
      "lng": -73.94293581685558,
      "location": "8c2a10c024e1bff",
      "name": "wobbly-lipstick-manatee",
      "nonce": 1,
      "owner": "142dmsAe4qVmNxdZJuQiFmpSnB9p6wBkAX78MVza1yNrF4t5R6e",
      "score": 0.25,
      "score_update_height": 403097,
      "status": {
        "gps": "good_fix",
        "height": 402961,
        "online": "online"
      }
    },
    {
      "address": "112Byc2EoL1yB7zyfC9ve2HayLoFf9WLvJdTDtevMsmkfxu9GAA1",
      "block": 403147,
      "block_added": 94932,
      "geocode": {
        "long_city": "Montrose",
        "long_country": "United States",
        "long_state": "New York",
        "long_street": "Sycamore Court",
        "short_city": "Montrose",
        "short_country": "US",
        "short_state": "NY",
        "short_street": "Sycamore Ct",
        "city_id": "bW9udHJvc2VuZXcgeW9ya3VuaXRlZCBzdGF0ZXM"
      },
      "lat": 41.24524348318981,
      "lng": -73.93254191072695,
      "location": "8c2a10c020337ff",
      "name": "smooth-cobalt-cougar",
      "nonce": 1,
      "owner": "142dmsAe4qVmNxdZJuQiFmpSnB9p6wBkAX78MVza1yNrF4t5R6e",
      "score": 0.25,
      "score_update_height": 403117,
      "status": {
        "gps": "good_fix",
        "height": 403026,
        "online": "online"
      }
    }
  ],   
"cursor": "eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ"
}
```
