---
title: "Cascading geo data for mobile proxy targeting"
method: GET
path: "/geo"
tags: ["Geo"]
---

# Cascading geo data for mobile proxy targeting

`GET /geo`

## Request

- Base URL: `https://dashboard.voidmob.com/api/v1`
- URL: `https://dashboard.voidmob.com/api/v1/geo`
- Auth: HTTP bearer

Hierarchical geo lookup:

- No params - countries with `available_nodes`
- `?country=X` - regions in that country
- `?country=X&region=Y` - cities in that region
- `?country=X&region=Y&city=Z` - ISPs in that city

Response is public-cacheable for 5 minutes.

## Query parameters

- `country` string
- `region` string
- `city` string

## Response `200`

One of countries, regions, cities, or ISPs depending on the parameters.

- object
  - `success` true, required
  - `data` union, required
    - object
      - `countries` GeoCountry[], required
        - `code` string, required
        - `name` string, required
        - `available_nodes` integer, required
    - object
      - `regions` GeoNode[], required
        - `name` string, required
        - `available_nodes` integer, required
    - object
      - `cities` GeoNode[], required
        - `name` string, required
        - `available_nodes` integer, required
    - object
      - `isps` GeoNode[], required
        - `name` string, required
        - `available_nodes` integer, required

## Other responses

- `401`: 401 - Authentication required.
- `429`: 429 - Rate limit exceeded. Retry after the indicated interval.

---

[API](https://skmtc.dev/voidmob/apis/voidmob-public-api.md) · [All operations](https://skmtc.dev/voidmob/apis/voidmob-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voidmob/apis/voidmob-public-api/revisions/066023313ebe?raw)