---
title: "Billing Status"
method: GET
path: "/api/v1/openai-ads/billing/status"
tags: ["openaiAds"]
---

# Billing Status

`GET /api/v1/openai-ads/billing/status`

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

## Query parameters

- `account_id` string, required: Quickads id of the connected ad account

## Response `200`

Successful Response

- OpenAIAdsResponseDTOBillingStatusDTO
  - `code` integer
  - `message` string
  - `data` BillingStatusDTO, required
    - `account_type` string, required
    - `payment_status` string, required
    - `currency` string, required
    - `wallet` WalletDTO
      - `balance` number, required
      - `safety_buffer` number, required
      - `low_balance_threshold` number, required
      - `auto_topup` AutoTopupDTO, required
        - `enabled` boolean, required
        - `threshold` number, required
        - `amount` number, required
    - `spend_cap` SpendCapDTO
      - `daily_limit` number, nullable
      - `revision` integer, nullable
      - `synced_at` string, nullable
      - `error` string, nullable
    - `invoices` InvoiceDTO[]
      - `id` string, required
      - `amount` number, required
      - `status` string, required
      - `created_at` string, nullable
      - `is_auto` boolean
      - `hosted_invoice_url` string, nullable
    - `ledger` LedgerEntryDTO[]
      - `id` string, required
      - `created_at` string, nullable
      - `type` string, required
      - `amount` number, required
      - `balance_after` number, required
      - `note` string, nullable
    - `fee` FeeSummaryDTO
      - `currency` string, required
      - `month_to_date_spend` number, required
      - `fee_rate` number, required
      - `monthly_minimum` number, nullable
      - `projected_month_spend` number, required
      - `projected_fee` number, required
      - `note` string, nullable
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-13** `c7202552278d`: 1 info
  - endpoint added

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