---
title: "GET /userprofiles/{userprofilesId}/targetableRemarketingLists"
method: GET
path: "/userprofiles/{userprofilesId}/targetableRemarketingLists"
tags: ["targetableRemarketingLists"]
---

# GET /userprofiles/{userprofilesId}/targetableRemarketingLists

`GET /userprofiles/{userprofilesId}/targetableRemarketingLists`

## Request

- Base URL: `https://dfareporting.googleapis.com/dfareporting/v5`
- URL: `https://dfareporting.googleapis.com/dfareporting/v5/userprofiles/{userprofilesId}/targetableRemarketingLists`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/dfatrafficking`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/dfatrafficking`
- TypeScript: <https://skmtc.dev/google/apis/dfareporting/docs/userprofiles/:userprofilesId/targetableRemarketingLists/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.

## Path parameters

- `userprofilesId` string, required

## Query parameters

- `advertiserId` string, int64, required
- `active` boolean
- `maxResults` integer
- `name` string
- `pageToken` string
- `sortField` 'ID' | 'NAME'
- `sortOrder` 'ASCENDING' | 'DESCENDING'

## Response `200`

Successful response

- TargetableRemarketingListsListResponse: Targetable remarketing list response
  - `kind` string: Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetableRemarketingListsListResponse".
  - `nextPageToken` string: Pagination token to be used for the next list operation.
  - `targetableRemarketingLists` TargetableRemarketingList[]: Targetable remarketing list collection.
    - `accountId` string, int64: Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
    - `active` boolean: Whether this targetable remarketing list is active.
    - `advertiserId` string, int64: Dimension value for the advertiser ID that owns this targetable remarketing list.
    - `advertiserIdDimensionValue` DimensionValue: Represents a DimensionValue resource.
      - `dimensionName` string: The name of the dimension.
      - `etag` string: The eTag of this response for caching purposes.
      - `id` string: The ID associated with the value if available.
      - `kind` string: The kind of resource this is, in this case dfareporting#dimensionValue.
      - `matchType` 'EXACT' | 'BEGINS_WITH' | 'CONTAINS' | 'WILDCARD_EXPRESSION': Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
      - `value` string: The value of the dimension.
    - `description` string: Targetable remarketing list description.
    - `id` string, int64: Targetable remarketing list ID.
    - `kind` string: Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetableRemarketingList".
    - `lifeSpan` string, int64: Number of days that a user should remain in the targetable remarketing list without an impression.
    - `listSize` string, int64: Number of users currently in the list. This is a read-only field.
    - `listSource` 'REMARKETING_LIST_SOURCE_OTHER' | 'REMARKETING_LIST_SOURCE_ADX' | 'REMARKETING_LIST_SOURCE_DFP' | 'REMARKETING_LIST_SOURCE_XFP' | 'REMARKETING_LIST_SOURCE_DFA' | 'REMARKETING_LIST_SOURCE_GA' | 'REMARKETING_LIST_SOURCE_YOUTUBE' | 'REMARKETING_LIST_SOURCE_DBM' | 'REMARKETING_LIST_SOURCE_GPLUS' | 'REMARKETING_LIST_SOURCE_DMP' | 'REMARKETING_LIST_SOURCE_PLAY_STORE': Product from which this targetable remarketing list was originated.
    - `name` string: Name of the targetable remarketing list. Is no greater than 128 characters long.
    - `subaccountId` string, int64: Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.

---

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