---
title: "GET /v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserLists"
method: GET
path: "/v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserLists"
tags: ["advertisers"]
---

# GET /v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserLists

`GET /v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserLists`

## Request

- Base URL: `https://displayvideo.googleapis.com`
- URL: `https://displayvideo.googleapis.com/v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserLists`
- Auth: OAuth 2 (implicit, authorization URL `https://accounts.google.com/o/oauth2/auth`, scopes: `https://www.googleapis.com/auth/display-video`) and OAuth 2 (authorization code, authorization URL `https://accounts.google.com/o/oauth2/auth`, token URL `https://accounts.google.com/o/oauth2/token`, scopes: `https://www.googleapis.com/auth/display-video`)

Retrieves first and third party user lists available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.

## Path parameters

- `advertiserId` string, required

## Query parameters

- `filter` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

## Changes

- **2026-10-10** `52cdb4885336`: 1 breaking
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/displayvideo/changes/v4/advertisers/:advertiserId/reachForecast:retrievePlannableUserLists/get.md)

---

[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/6329126f9fb6?raw)