---
title: "List Campaign Options"
method: GET
path: "/v2/campaigns/options"
tags: ["Campaigns"]
---

# List Campaign Options

`GET /v2/campaigns/options`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/campaigns/options`
- Auth: API key in header `x-api-key`

Get a short list of your campaigns with only their ID, name, status, and tags. Handy for filters and pickers. Requires the customers:view permission.

## Response `200`

GET /v2/campaigns/options Positive response

- GetV2CampaignsOptionsPositiveResponse
  - `items` object[], required: Campaigns available to filter/enroll customers into
    - `id` string, uuid, required
    - `name` string, required
    - `status` 'draft' | 'active' | 'paused' | 'completed' | 'archived' | 'cancelled', required
    - `isReceptionist` boolean, required

## Other responses

- `400`: GET /v2/campaigns/options Negative response 400
- `401`: GET /v2/campaigns/options Negative response 401
- `403`: GET /v2/campaigns/options Negative response 403
- `404`: GET /v2/campaigns/options Negative response 404
- `409`: GET /v2/campaigns/options Negative response 409
- `422`: GET /v2/campaigns/options Negative response 422
- `429`: GET /v2/campaigns/options Negative response 429
- `500`: GET /v2/campaigns/options Negative response 500
- `502`: GET /v2/campaigns/options Negative response 502
- `503`: GET /v2/campaigns/options Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)