---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/GetRegions.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetRegions.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/en/llms.txt

# GetRegions (Live)
Returns a list of regions registered in Yandex Direct.
Information about regions can be useful when analyzing campaign statistics, forecasting impressions and clicks (using the [CreateNewForecast](https://yandex.com/dev/direct/doc/dg-v4/en/reference/CreateNewForecast.md) method), and creating or editing ads.

## New in the Live 4 version

Added the RegionType parameter.


## Input data {#input}

The input data structure in JSON is shown below.

```javascript
{
   "method": "GetRegions"
}
```


## Output data {#output}

The method returns an array of `RegionInfo` objects, each of which corresponds to a single region. The output data structure in JSON is shown below.

```javascript
{
   "data": [
      {  /* RegionInfo */
         "RegionID": (int),
         "ParentID": (int),
         "RegionName": (string),
         "RegionType": (string)
      }
      ...
   ]
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
||

||
**<sub >RegionInfo object</sub>**
||
||
`RegionID`
|
Region ID in Yandex Direct.
||
||
`ParentID`
|
ID of the higher-level region.
||
||
`RegionName`
|
Name of the region.
||
||
`RegionType`
|
Type of region. Possible values: Continent, Region, Country, Administrative area, City, Village.
||
|#