---
title: "List Campaigns"
method: GET
path: "/api/v1/openai-ads/campaigns"
tags: ["openaiAds"]
---

# List Campaigns

`GET /api/v1/openai-ads/campaigns`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/openai-ads/campaigns`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `account_id` string, required: Quickads id of the connected ad account
- `days` integer: Trailing whole days in the ad account's timezone, today included
- `since` string, date, nullable
- `until` string, date, nullable

## Response `200`

Successful Response

- OpenAIAdsResponseDTOListCampaignSummaryDTO
  - `code` integer
  - `message` string
  - `data` CampaignSummaryDTO[], required
    - `id` string, required
    - `account_id` string, required
    - `name` string, required
    - `status` string, required
    - `paused_by_wallet` boolean
    - `bidding_type` string, required
    - `conversion_event_setting_id` string, nullable
    - `budget` BudgetDTO, required
      - `type` 'daily' | 'lifetime', required
      - `amount` number, required
    - `targeting` TargetingDTO, required
      - `locations` string[]
      - `all_locations` boolean
      - `excluded_locations` string[]
      - `platforms` string[]
      - `openai_platforms` string[], nullable
    - `ad_groups` AdGroupDTO[]
      - `id` string, required
      - `name` string, required
      - `context_hints` string[]
      - `max_bid` number, nullable
      - `status` string, required
      - `serving_issues` string[]
      - `ads` AdDTO[]
        - `id` string, required
        - `name` string, required
        - `title` string, required
        - `body` string, required
        - `target_url` string, nullable
        - `file_id` string, nullable
        - `image_url` string, nullable
        - `status` string, required
        - `review_status` 'approved' | 'in_review' | 'rejected', required
        - `review_reason` string, nullable
        - `serving_issues` string[]
    - `start_time` integer, nullable
    - `end_time` integer, nullable
    - `created_at` string, nullable
    - `created_via` 'quickads' | 'external'
    - `serving_issues` string[]
    - `metrics` MetricTotalsDTO, required
      - `impressions` number
      - `clicks` number
      - `spend` number
      - `conversions` number
      - `ctr` number
      - `cpc` number
      - `cpm` number
      - `cpa` number
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-22** `23eb62d854e6`: 2 info
  - added the new optional `query` request parameter `since`
  - added the new optional `query` request parameter `until`
- **2026-10-13** `c7202552278d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/campaigns/get.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)