---
title: "List ad sets"
method: GET
path: "/v1/ads/ad-sets"
tags: ["Ad Campaigns"]
---

# List ad sets

`GET /v1/ads/ad-sets`

Ad sets (Google ad groups) synced for the connection, optionally
filtered by platform and campaignId. Reads the `ad_sets` table
directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a
newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets,
Google only) is visible here even though it is invisible in the tree
until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500
rows, newest first.

## Query parameters

- `accountId` string
- `campaignId` string
- `platform` 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai'

## Response `200`

Ad sets

- object
  - `adSets` object[]
    - `platformAdSetId` string
    - `platform` string
    - `adSetName` string, nullable
    - `status` string, nullable
    - `platformAdSetStatus` string, nullable
    - `platformCampaignId` string, nullable
    - `platformAdAccountId` string
    - `accountId` string, nullable
    - `profileId` string
    - `currency` string, nullable
    - `budget` object, nullable
    - `isExternal` boolean, nullable
    - `platformCreatedAt` string, date-time, nullable

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Ads access required (Ads add-on on legacy plans, included on usage-based plans).

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status
- **2026-09-08** `d7a8fa118ef0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/ad-sets/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/fdaf9a9fb1a7?raw)