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

# list_campaigns

> Campaigns across connected ad platforms with status, objective, and budget snapshot.

Returns a unified campaign list across Facebook, Google, LinkedIn, and TikTok.

## When to use

* "List my active campaigns."
* "Which campaigns are paused?"

For full detail on one campaign (creative, targeting, delivery), use [`get_ad_entity`](https://docs.cometly.com/mcp/tools/get-ad-entity). For ranked performance rollups, use [`query_metric_breakdown`](https://docs.cometly.com/mcp/tools/query-metric-breakdown).

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `sources` | string\[] | No | Source slugs to include. |
| `status` | string | No | Filter by status (`active`, `paused`, …). |
| `name_like` | string | No | Case-insensitive substring filter on name. |
| `limit` | integer | No | Max rows total (1–500, default 200). Divided across the included sources. |
| `format` | string | No | `csv` (default), `json`, or `yaml`. |

## Output

```csv theme={null}
source,id,account_id,name,status,objective,budget,updated_at
facebook_ads,1100012345,act_1234567890,Spring Launch,active,CONVERSIONS,150.00,2026-05-15T...
google_ads,1100098765,111-222-3333,Acme Brand Search,active,SEARCH,200.00,2026-05-15T...
```


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