---
title: "List campaigns"
method: GET
path: "/v1/campaigns"
tags: ["Campaigns"]
---

# List campaigns

`GET /v1/campaigns`

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'Scheduled' | 'Running' | 'Stopped' | 'Completed' | 'Failed' | 'Expired' | 'Paused'
- `created_after` string, date-time
- `created_before` string, date-time

## Response `200`

List of campaigns

- ListCampaignsResponse
  - `campaigns` CampaignResponse[]
    - `id` integer — Unique identifier.
    - `name` string — Campaign name.
    - `type` 'outbound' — Campaign type (always outbound).
    - `status` 'Scheduled' | 'Running' | 'Stopped' | 'Completed' | 'Failed' | 'Expired' | 'Paused' — Current campaign status.
    - `bot_uid` string — Bot UID for API reference.
    - `from_number` string — Phone number used to dial from (E.164 format).
    - `contact_list_id` integer — Associated contact list ID.
    - `time_start` string — Daily calling window start time in HH:MM format.
    - `time_end` string — Daily calling window end time in HH:MM format.
    - `timezone` string — Calling window timezone (IANA format).
    - `days` string[] — Days of week the campaign runs on (for recurring campaigns).
    - `schedule_type` 'single' | 'multi' — Schedule type: single (one-time) or multi (recurring on specific days).
    - `current_index` integer — Number of contacts already called.
    - `total_contacts` integer — Total number of contacts in the campaign's contact list.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `total` integer
    - `has_more` boolean

---

[API](https://skmtc.net/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.net/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/71c32e6ffd95/schema)