---
title: "GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations"
method: GET
path: "/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations"
tags: ["advertisers"]
---

# GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations

`GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations`

## Request

- Base URL: `https://displayvideo.googleapis.com`
- URL: `https://displayvideo.googleapis.com/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/display-video`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/display-video`
- TypeScript: <https://skmtc.dev/google/apis/displayvideo/docs/v4/advertisers/:advertisersId/reachForecast:retrievePlannableLocations/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the list of countries where reach forecasting is supported. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.

## Path parameters

- `advertisersId` string, required

## Response `200`

Successful response

- RetrievePlannableLocationsResponse: Response for RetrievePlannableLocations
  - `plannableLocations` PlannableLocation[]: Output only. The list of plannable locations.
    - `displayName` string: Output only. The display name of the location, for example "Algeria".
    - `geoRegionType` 'GEO_REGION_TYPE_UNKNOWN' | 'GEO_REGION_TYPE_OTHER' | 'GEO_REGION_TYPE_COUNTRY' | 'GEO_REGION_TYPE_REGION' | 'GEO_REGION_TYPE_TERRITORY' | 'GEO_REGION_TYPE_PROVINCE' | 'GEO_REGION_TYPE_STATE' | 'GEO_REGION_TYPE_PREFECTURE' | 'GEO_REGION_TYPE_GOVERNORATE' | 'GEO_REGION_TYPE_CANTON' | 'GEO_REGION_TYPE_UNION_TERRITORY' | 'GEO_REGION_TYPE_AUTONOMOUS_COMMUNITY' | 'GEO_REGION_TYPE_DMA_REGION' | 'GEO_REGION_TYPE_METRO' | 'GEO_REGION_TYPE_CONGRESSIONAL_DISTRICT' | 'GEO_REGION_TYPE_COUNTY' | 'GEO_REGION_TYPE_MUNICIPALITY' | 'GEO_REGION_TYPE_CITY' | 'GEO_REGION_TYPE_POSTAL_CODE' | 'GEO_REGION_TYPE_DEPARTMENT' | 'GEO_REGION_TYPE_AIRPORT' | 'GEO_REGION_TYPE_TV_REGION' | 'GEO_REGION_TYPE_OKRUG' | 'GEO_REGION_TYPE_BOROUGH' | 'GEO_REGION_TYPE_CITY_REGION' | 'GEO_REGION_TYPE_ARRONDISSEMENT' | 'GEO_REGION_TYPE_NEIGHBORHOOD' | 'GEO_REGION_TYPE_UNIVERSITY' | 'GEO_REGION_TYPE_DISTRICT' | 'GEO_REGION_TYPE_NATIONAL_PARK' | 'GEO_REGION_TYPE_BARRIO' | 'GEO_REGION_TYPE_SUB_WARD' | 'GEO_REGION_TYPE_MUNICIPALITY_DISTRICT' | 'GEO_REGION_TYPE_SUB_DISTRICT' | 'GEO_REGION_TYPE_QUARTER' | 'GEO_REGION_TYPE_DIVISION' | 'GEO_REGION_TYPE_COMMUNE' | 'GEO_REGION_TYPE_COLLOQUIAL_AREA' | 'GEO_REGION_TYPE_POST_TOWN' | 'GEO_REGION_TYPE_WARD': Output only. The type of location.
    - `name` string: Output only. The resource name of the plannable location.
    - `parentPlannableLocationId` string, int64: Output only. The parent plannable location ID, for example the country ID for subgeos.
    - `plannableLocationId` string, int64: Output only. The plannable location ID.
    - `regionCode` string: Output only. The region code of the location, for example "DZ" for Algeria.

---

[API](https://skmtc.dev/google/apis/displayvideo.md) - [All operations](https://skmtc.dev/google/apis/displayvideo/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/displayvideo/revisions/d80b56b6703a?raw)