> For the complete documentation index, see [llms.txt](https://doc.thordata.com/interface-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/interface-documentation/public-api/location/get-city-list.md).

# Get City List

### Basic Information

**Interface Description:** Get the list of cities supported by Thordata Residential Proxies or Unlimited Proxy Servers through the interface

**Interface URL:** <https://openapi.thordata.com/api/locations/cities>

**Request Method:** <mark style="color:green;">GET</mark>

### Request parameters

**Params：**

<table><thead><tr><th>Parameter name</th><th>Type</th><th width="127">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>token</code></td><td>string</td><td>Yes</td><td>Please log in to the  <a href="https://dashboard.thordata.com/account-settings"><strong>Dashboard-MENU-My Account</strong></a> to view your token parameter value</td></tr><tr><td><code>proxy_type</code></td><td>number</td><td>Yes</td><td>Select the proxy type: 1 is Residential Proxies, 2 is Unlimited Proxy servers (default is 1)</td></tr><tr><td><code>country_code</code></td><td>string</td><td>Yes</td><td>Enter the country code to get the city list of the corresponding country</td></tr><tr><td><code>state_code</code></td><td>string</td><td>No</td><td>Enter a state code to get a list of cities in the corresponding state</td></tr></tbody></table>

### Response example

```json
{
    "code": 200,
    "data": [
        {
            "country_code": "US",
            "country_name": "United States",
            "state_code": "alabama",
            "state_name": "Alabama",
            "city_code": "alabaster",
            "city_name": "Alabaster"
        },
        {
            "country_code": "US",
            "country_name": "United States",
            "state_code": "alabama",
            "state_name": "Alabama",
            "city_code": "alexandercity",
            "city_name": "Alexander City"
        },
        {
            "country_code": "US",
            "country_name": "United States",
            "state_code": "alabama",
            "state_name": "Alabama",
            "city_code": "andalusia",
            "city_name": "Andalusia"
        },
    ],
    "msg": "ok"
}
```

{% hint style="info" %}
If the returned code value is not 200, please check the [**error code description list**](https://doc.thordata.com/interface-documentation/error-code/error-code-description) and modify it.
{% endhint %}

<table><thead><tr><th width="206">Parameter name</th><th>Type</th><th width="139">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>code</code></td><td>number</td><td>No</td><td>-</td></tr><tr><td><code>data</code></td><td>object</td><td>No</td><td>-</td></tr><tr><td><code>country_code</code></td><td>string</td><td>Yes</td><td>Country code</td></tr><tr><td><code>country_name</code></td><td>string</td><td>Yes</td><td>Country name</td></tr><tr><td><code>state_code</code></td><td>string</td><td>Yes</td><td>State code</td></tr><tr><td><code>state_name</code></td><td>string</td><td>Yes</td><td>State name</td></tr><tr><td><code>city_code</code></td><td>string</td><td>Yes</td><td>City code</td></tr><tr><td><code>city_name</code></td><td>string</td><td>Yes</td><td>City name</td></tr><tr><td><code>msg</code></td><td>string</td><td>No</td><td>-</td></tr></tbody></table>