> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Invoices

> Lists the monthly invoices of a Meta Business Manager, optionally with the spend billed per campaign and the invoice PDFs

Lists the monthly invoices of a Meta Business Manager, optionally with the spend billed per campaign and the invoice PDFs. Only businesses on monthly invoicing have invoices, and the user needs the Finance Analyst or Finance Editor role; card-paid accounts return no invoices.

| | |
| - | - |
| **App** | Meta Ads |
| **Operation ID** | `meta_ads_list_invoices` |
| **Type** | Action |
| **Connection** | `meta_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `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. |

### DateRange

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `start` | string | No | - | The start date of the date range to query, format: YYYY-MM-DD or dynamic node reference like \{\{nodeId\_\_data.start\_date}}. Required when preset is 'FIXED' or 'CUSTOM'. |
| `end` | string | No | - | The end date of the date range to query, format: YYYY-MM-DD or dynamic node reference like \{\{nodeId\_\_data.end\_date}}. Required when preset is 'FIXED' or 'CUSTOM'. |
| `preset` | string | No | - | Predefined date ranges or input modes: - Use 'FIXED' or leave empty when you want to specify exact dates (YYYY-MM-DD format) in start/end fields - Use 'CUSTOM' when you want to use dynamic values from other nodes (\{\{nodeId\_\_data.start\_date}} format) in start/end fields - Use other presets (TODAY, YESTERDAY, LAST\_7\_DAYS, etc.) for predefined date ranges (start/end will be ignored) LAST\_N\_MONTHS and LAST\_N\_WEEKS are complete calendar periods ending with last month or last week, so they exclude the current month or week; for a rolling window up to yesterday use LAST\_N\_DAYS (for example LAST\_90\_DAYS) or a FIXED range. When using 'FIXED' or 'CUSTOM', both start and end fields are required. |
| `compare` | CompareOptions | No | - | Optional comparison date range settings. ALWAYS use this field for comparisons; DO NOT create additional requests or nodes, as the backend returns current, comparison, and delta metrics in a single call. If one period has no data at all, only the period with data is returned and no delta row; treat the missing period as zero. |

### SelectItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | The value of the selectable item. |
| `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### CompareOptions

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `start` | string | No | - | The start date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided. |
| `end` | string | No | - | The end date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided. |
| `preset` | string | No | - | Predefined comparison ranges. When provided, start and end will be ignored. |
| `comparison_format` | string | No | `rows` | Comparison output layout: 'rows' returns separate rows for current, comparison, and delta along with date ranges; 'columns' returns a single row with delta values only as additional \*\_pct or \*\_change columns depending on comparison\_value\_type. |
| `comparison_value_type` | string | No | `percentage` | Value type: 'percentage' or 'absolute' |

## Output

**Type**: `List[Dict]`

One row per invoice as Meta returns it: id, invoice\_id, type, invoice\_type, billing\_period, invoice\_date, due\_date, currency, amount, amount\_due, billed\_amount\_details, payment\_status, payment\_term, liability\_type, entity, advertiser\_name, ad\_account\_ids, download\_uri, cdn\_download\_uri, plus campaigns and pdfFileUrl when requested.

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.