---
title: "Clients"
method: GET
path: "/api/v1/openai-ads/clients"
tags: ["openaiAdsOnboarding"]
---

# Clients

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

## 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/clients`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

Successful Response

- OpenAIAdsResponseDTOClientsDTO
  - `code` integer
  - `message` string
  - `data` ClientsDTO, required
    - `oauth_available` false
    - `client_workflows_available` boolean, required
    - `accounts` ClientAccountDTO[], required
      - `id` string, required
      - `ad_account_id` string, required
      - `name` string, nullable
      - `url` string, nullable
      - `currency` string, required
      - `timezone` string, required
      - `status` string, nullable
      - `review_status` 'approved' | 'in_review' | 'rejected' | 'missing_favicon', required
      - `review_reason` string, nullable
      - `review_message` string, nullable
      - `account_type` 'quickads_owned' | 'user_owned', required
      - `payment_status` 'active' | 'pending_payment' | 'unknown', required
      - `api_key_last4` string, required
      - `connected_at` string, nullable
      - `last_synced_at` string, nullable
      - `conversion_events` ConversionEventDTO[]
        - `id` string, required
        - `name` string, nullable
        - `event_type` string, required
        - `archived` boolean
      - `role` 'owner' | 'editor' | 'viewer' | 'approver', required
      - `require_approval` boolean, required
  - `error_code` string, nullable

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-14** `707bf96f76de`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/clients/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)