TOOL API

advertiser_balance_get

Gets the balance of ad accounts in a Business Center and, for ad accounts owned by the Business Center in auto-allocation mode, their budget information. Only ad accounts for which the Business Center has administrator permissions are returned. Both Agency and Direct Business Centers can perform payment-related operations. Only users with Finance Manager or Finance Analyst permission can manage payments and invoices in a Business Center; member access can be configured with /bc/member/invite/ and /bc/member/update/. Reservation ad accounts cannot use monthly budget, daily budget, or custom budget for Balance Sharing. Multiple Payment Portfolios for one client is an allowlist-only feature.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.advertiser_balance_get
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

bc_idrequired

Business Center ID.

fields

List of additional response fields to return. Supported values: `budget_remaining`, `budget_frequency_restriction`, `budget_amount_restriction`, `min_transferable_amount`, `max_transferable_amount`, and `balance_info`. If omitted, all standard information is returned by default except `budget_remaining`, `budget_frequency_restriction`, `min_transferable_amount`, `max_transferable_amount`, and `balance_info`. To retrieve these additional fields together with other fields, set `fields` to `["budget_remaining", "budget_frequency_restriction", "budget_amount_restriction", "min_transferable_amount", "max_transferable_amount", "balance_info"]` and set `page_size` to `1`.

filtering

Filtering conditions.

page

Page number. Default is `1`. Must be greater than or equal to `1`.

page_size

Page size. Default is `10`. Supported range: `1` to `50`. Set `page_size` to `1` when requesting the additional fields `budget_remaining`, `budget_frequency_restriction`, `budget_amount_restriction`, `min_transferable_amount`, `max_transferable_amount`, and `balance_info` together with other fields.