---
title: "List portfolio bid strategies"
method: GET
path: "/v1/ads/bid-strategies"
tags: ["Ad Campaigns"]
---

# List portfolio bid strategies

`GET /v1/ads/bid-strategies`

Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource, cached for the quota window. Draws on the shared Google Ads operations budget. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

## Query parameters

- `accountId` string, required
- `customerId` string
- `fromDate` string, date
- `toDate` string, date

## Response `200`

Portfolio bid strategies

- object
  - `customerId` string
  - `currency` string — Account currency code; money fields are in this currency's units.
  - `strategies` PortfolioBidStrategy[]
    - `id` string — Numeric bid strategy id; pass as portfolioBidStrategyId or in the {strategyId} path.
    - `name` string
    - `type` 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE'
    - `status` string — ENABLED or REMOVED.
    - `campaignCount` integer — Number of campaigns currently attached.
    - `clicks` integer
    - `cost` number — Cost in the account's currency units (converted from micros).
    - `costPerConversion` number — Cost per conversion in the account's currency units.
    - `impressions` integer
    - `averageCpc` number — Average CPC in the account's currency units.
    - `conversions` number
    - `targetCpa` number, nullable — Current target, in the account's currency units. Null for a ROAS-family type (TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE), or a Maximize type with no target set. Pre-fills the edit form's target field.
    - `targetRoas` number, nullable — Current target as a decimal multiplier (2.0 = 2.0x). Null for a CPA-family type (TARGET_CPA, MAXIMIZE_CONVERSIONS), or a Maximize type with no target set.
  - `cachedAt` string, date-time, nullable — When this data was fetched from Google. Null when it was never served from cache.
  - `stale` boolean — True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — The account or requested resource was not found or is not accessible. An account ID may have been disconnected and removed. Read GET /v1/accounts for current account IDs.
- `409` — The account exists but is inactive or needs reconnection. Reconnect it, then read GET /v1/accounts for its current account ID before retrying. Code: ads_connection_required.
- `429` — Google Ads operations budget exhausted; retry later.
- `501` — Only available on Google Ads accounts

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 3 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `404` status
  - added the optional property `details/budgetScope` to the response with the `409` status
- **2026-09-15** `0dba7d004d75` — 6 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `404` status
  - added the optional property `details/quotaExhausted` to the response with the `409` status
  - added the optional property `details/quotaScope` to the response with the `400` status
  - …2 more
- **2026-09-10** `e70ed06e7150` — 7 info
  - added the non-success response with the status `409`
  - added the optional property `code` to the response with the `404` status
  - added the optional property `details` to the response with the `404` status
  - added the optional property `param` to the response with the `404` status
  - …3 more
- **2026-09-08** `d7a8fa118ef0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/bid-strategies/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/eded32b62823?raw)