TOOL API

bc_account_transaction_get

Retrieves transaction records for a Business Center, its ad accounts, or its Payment Portfolio from /open_api/v1.3/bc/account/transaction/get/. You must have a Finance role on the Business Center (Finance Manager or Finance Analyst). To confirm your Finance permission and obtain accessible Business Centers, call /bc/get/ and check `finance_role`. When `transaction_level` is `ADVERTISER` or omitted, results are for ad accounts; when a Business Center has enabled Payment Portfolio, transactions of ad accounts shared by other Business Centers will not be returned. The docs also reference Payment Portfolio retrieval, though the example uses `PAYMENT_ACCOUNT` while the documented enum is `PAYMENT_PORTFOLIO`.

ecommerceOAuth1 credits

Call information

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

Input parameters

bc_idrequired

Business Center ID whose transaction records you want to retrieve.

filtering

Filtering conditions for the transaction query.

page

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

page_size

Number of records per page. Default is 10. Allowed range: 1-50.

transaction_level

Level at which to retrieve transactions. `BC` returns transactions for the Business Center identified by `bc_id`; `ADVERTISER` returns transactions for ad accounts within `bc_id`; `PAYMENT_PORTFOLIO` returns Payment Portfolio transactions. Default is `ADVERTISER`. If a Business Center has enabled Payment Portfolio, transactions of ad accounts shared by other Business Centers will not be returned.