---
title: "List campaigns"
method: GET
path: "/campaigns"
---

# List campaigns

`GET /campaigns`

## Request

- Base URL: `https://lazyads.ai/api/v1`
- URL: `https://lazyads.ai/api/v1/campaigns`
- Auth: HTTP bearer

Returns campaigns for the authenticated account with lifetime performance aggregates.

## Query parameters

- `status` 'draft' | 'active' | 'paused' | 'completed' | 'error'
- `platform` 'meta' | 'google' | 'tiktok' | 'linkedin' | 'reddit' | 'apple' | 'bing' | 'chatgpt' | 'snapchat'
- `limit` integer
- `offset` integer

## Response `200`

A list of campaigns with `pagination`

## Other responses

- `401`: Missing or invalid API key
- `403`: Plan does not include this endpoint, key lacks the scope, or agency access denied
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/lazyads/apis/lazyads-api.md) · [All operations](https://skmtc.dev/lazyads/apis/lazyads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lazyads/apis/lazyads-api/revisions/7d5de42538e9?raw)
