List ad accounts (token-bound client only)

Tenancy

Resolved only from the Bearer token (api_clients.bound_business_client_uuid).

Do not pass business client_id / client_number in query or body — returns 400 CLIENT_ID_NOT_ALLOWED.

Open-platform client_id (caa_ck_...) is only for exchanging a tenant_access_token.

If api_clients.allowed_meta_ids is set: lists only those Meta accounts; writes elsewhere → 403 FORBIDDEN_ACCOUNT; detail GETs → 404.

Hard rate limit: 10 requests / second per API client for this path. Over limit → 429 RATE_LIMITED + Retry-After.

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Paged list

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "items": [
            {
                "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                "name": "Demo Ad Account",
                "meta_id": "123456789012345",
                "account_status": 1,
                "astatus": "active",
                "balance": 120.5,
                "spend_cap": 1000,
                "amount_spent": 80.25,
                "total_spend": 540.1,
                "currency_code": "USD",
                "timezone": "America/Los_Angeles",
                "ad_account_type_name": "Standard",
                "client_number": "C0001",
                "created_at": "2026-10-01T00:00:00.000Z",
                "updated_at": "2026-10-02T00:00:00.000Z"
            }
        ],
        "total": 1
    },
    "request_id": "string"
}

🟠400

🟠429

请求参数

请求示例代码

返回响应