---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/dictionaries/getGeoRegions.md
  - https://yandex.com/dev/direct/doc/ru/dictionaries/getGeoRegions.md
  - href: en/dictionaries/getGeoRegions.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/ref-v5/dictionaries/getGeoRegions.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# getGeoRegions

Returns a list of regions available for targeting.

## Request {#input}

Request structure in JSON format:

```javascript
{
  "method": "get",
  "params" : { /* required */
    "Page" : {
      "Limit" : (long),
      "Offset" : (long)
    },
    "SelectionCriteria" : { /* required */
      "Name" : (string),
      "RegionIds" : [ (long) ],
      "ExactNames" : [ (string) ]
    },
    "FieldNames" : [ ("GeoRegionId" |"GeoRegionName"|"ParentGeoRegionNames") ] /* required */
  }
}
```


#|
||
**Parameter** 
|
**Type** 
|
**Description** 
|
**Required**
||
||
**params structure (for JSON) / GetRequest (for SOAP)**
|
>
|
>
|
>
||
||
`Page`
|
LimitOffset
|
Structure that defines the page for [paginated selection](https://yandex.com/dev/direct/doc/dg/best-practice/get.html#page) of data.
|
No
||
||
`SelectionCriteria`
|
GeoRegionsSelectionCriteria
|
Region selection criteria.

Provide at least one of these parameters: `Name`, `RegionIds`, or `ExactNames`.

If the request includes the parameter:

- `Name`: The method will return the results for regions with a similar name.
- `RegionIds`: The method will return the results for the specified region IDs.
- `ExactNames`: The method will return the results for matching region names.
|
Yes
||
||
`FieldNames`
|
array of AdFieldEnum
|
Names of top-level parameters to get.
|
Yes
||
||
**GeoRegionsSelectionCriteria structure**
|
>
|
>
|
>
||
||
`Name`
|
string
|
Select regions with similar names.
|
No, if `RegionIds` or `ExactNames` is specified.
||
||
`RegionIds`
|
array of long
|
Selects regions with the specified IDs.
|
No, if `Name` or `ExactNames` is specified.
||
||
`ExactNames`
|
array of string
|
Select regions with exactly matching names.
|
No, if `Name` or `RegionIds` is specified.
||
|# 


## Response {#output}

Response structure in JSON format:

```javascript
{
  "result" : { /* required */
    "LimitedBy" : (long),
    "GeoRegions" : [{
      "GeoRegionId" : (long),
      "GeoRegionName" : (string),
      "ParentGeoRegionNames" : { /* nillable */
        "Items" : [ (string) ] /* required */
      }
    }, .. (unbounded)]
  }
}
```


#|
||
**Parameter** 
|
**Type** 
|
**Description** 
||
||
**result structure (for JSON) / GetResponse (for SOAP)**
|
>
|
>
||
||
`LimitedBy`
|
long
|
Sequential number of the last object returned. It is included if there was a limit on the number of objects in the response. See the section [Paginated data selection](https://yandex.com/dev/direct/doc/dg/best-practice/get.html#page).
||
||
`GeoRegions`
|
array of GeoRegionsGetItem
|
List of regions.
||
||
**GeoRegionsGetItem structure**
|
>
|
>
||
||
`GeoRegionId`
|
long
|
ID of the region.
||
||
`GeoRegionName`
|
string
|
Name of the region in the language specified in the HTTP [Accept-Language](https://yandex.com/dev/direct/doc/dg/concepts/headers.html#accept-language) header in the request.
||
||
`ParentGeoRegionNames`
|
array of string
|
Array of names of higher-level regions.
||
|#