> ## 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`](/mcp/tools/get-ad-entity). For ranked performance rollups, use [`query_metric_breakdown`](/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...
```