bc_id | string or SelectItem | Yes | - | Business Center ID whose invoices to list. This is not an advertiser_id; get it from tiktok_ads_list_business_centers. |
date_range | DateRange | No | - | Invoice issue dates to include, both ends inclusive. Use preset=‘FIXED’ with start/end dates (YYYY-MM-DD), or a preset such as LAST_6_MONTHS. Default: all invoices. |
invoice_types | array of enum (RECON, CREDIT, AUTO_PAY) | No | - | Only these invoice types: RECON (reconciliation), CREDIT (monthly invoicing) and AUTO_PAY (automatic payment). Default: all three. |
pay_statuses | array of enum (UNPAID, PAID, PARTIAL_PAID, NO_NEED) | No | - | Only invoices in these payment statuses. Default: all. |
invoice_id | string | No | - | Invoice ID, to fetch one invoice. |
invoice_title | string | No | - | Only invoices with this title. |
download_pdf | boolean | No | False | Set true to download each invoice PDF into a private Markifact file and add its link as pdfFileUrl. |
include_billing_report | boolean | No | False | Set true to save each invoice’s detailed transaction report (Excel) into a private Markifact file and add its link as billingReportFileUrl. TikTok builds each report on request, so use a narrow date_range or invoice_id. |