business | string or SelectItem | Yes | - | The Business Manager whose invoices to list, by business id, e.g. ‘723329271357960’. Get ids from meta_ads_list_businesses. |
date_range | DateRange | No | - | Invoices to include, by billing period or issue date (see date_type), both ends inclusive. Use preset=‘FIXED’ with start/end dates (YYYY-MM-DD), or a preset such as LAST_6_MONTHS. Default: billing periods of the last 6 months. |
date_type | enum (billing_period, issue_date) | No | - | What date_range filters on. ‘billing_period’ (default): the month the spend happened, dated its first day, so the October 2026 invoice has billing_period 2026-10-01. ‘issue_date’: the date Meta issued it. |
invoice_type | enum (INV, CM, DM, PRO_FORMA) | No | - | Only invoices of this type: INV (invoice), CM (credit memo), DM (debit memo) or PRO_FORMA. Default: all types. |
invoice_id | string | No | - | Invoice number, to fetch one invoice. Meta ignores every other filter when it is set. |
include_campaigns | boolean | No | False | Set true to add each invoice’s campaign breakdown as campaigns: campaign_id, campaign_name, ad_account_id, billed_amount_details, impressions, clicks, conversions, tags. |
download_pdf | boolean | No | False | Set true to download each invoice PDF into a private Markifact file and add its link as pdfFileUrl. |