# Get all locations

### **Endpoint:**

<mark style="color:green;">`GET`</mark> `https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/geo`

#### **Example:**

```
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/resident/geo
```

### **Response:**

{% tabs %}
{% tab title="200: OK Success response " %}

```json
You will see in downloaded JSON file all information about GEO:

[
    {
        "code": "AD",
        "name": "Andorra",
        "regions": [
            {
                "name": "Andorra la Vella",
                "code":118,
                "cities": [
                    {
                        "name": "Andorra la Vella",
                        "isps": [
                            "GSL Networks",
                            "Andorra Telecom, S.a.u.",
                            "Cyberzone"
                        ]
                    }
                ]
            },
            {
                "name": "XX",
                "cities": [
                    {
                        "name": "unknown",
                        "isps": [
                            "Andorra Telecom, S.a.u."
                        ]
                    }
                ]
            }
        ]
    },
    {
        "code": "AE",
        "name": "United Arab Emirates",
...
```

{% endtab %}

{% tab title="200: OK Error response Wrong API key" %}

```json
You will see in downloaded JSON file:

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong authorization IP" %}

```json
You will see in downloaded JSON file:

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Path parameter&#x73;**:**

<table data-full-width="false"><thead><tr><th width="149">Name</th><th width="184">Value</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Authorization</td><td><code>&#x3C;Your_API_Key></code></td><td>Your personal API key</td><td></td></tr></tbody></table>

{% hint style="warning" %}
Click the 'Save and download' button to download a ZIP file containing JSON and the list of GEO data with all relevant information
{% endhint %}

<figure><img src="https://1982502377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRme5tjIw8D2wPlwSNAx%2Fuploads%2FSlzzd71G2nVz7og4G2EL%2Fimage.png?alt=media&#x26;token=dcf08d9a-b966-4fec-b3b6-912dd5d4366b" alt=""><figcaption></figcaption></figure>