---
title: "List Facebook ads"
method: GET
path: "/api/v1/facebook/ads"
---

# List Facebook ads

`GET /api/v1/facebook/ads`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/facebook/ads`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

List ads from the connected Facebook Ad account with optional filtering by campaign, ad set, or status. Use when user asks 'show my Facebook ads', 'list ads for campaign', 'what ads are running'.

## Query parameters

- `campaign_id` string
- `ad_set_id` string
- `status` string
- `limit` integer

## Response `200`

List of Facebook ads

- object

## Other responses

- `401`: Authentication required
- `500`: Internal server error
- `503`: Facebook Marketing not configured or not authenticated

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)