---
title: "Get All Campaigns"
method: GET
path: "/campaign/all"
tags: ["campaign"]
---

# Get All Campaigns

`GET /campaign/all`

Retrieves a paginated list of campaigns for the current user with optional call count information.

## Query parameters

- `call_count` boolean
- `limit` integer
- `offset` integer

## Headers

- `X-API-KEY` string, required

## Response `200`

List of campaigns retrieved successfully.

- object
  - `campaigns` object[]
    - `id` string — Campaign unique identifier
    - `name` string — Campaign name
    - `campaign_status` 'pending' | 'registered' | 'running' | 'completed' | 'paused' — Current status of the campaign
    - `created_at` string, date-time — Campaign creation timestamp
    - `updated_at` string, date-time — Campaign last update timestamp
    - `campaign_start_time` string, date-time — Scheduled start time for the campaign
    - `campaign_end_time` string, date-time — Scheduled end time for the campaign
    - `total_count` integer — Total number of calls in campaign (only included when call_count=true)
    - `registered_count` integer — Number of registered calls (only included when call_count=true)
    - `completed_count` integer — Number of completed calls (only included when call_count=true)
  - `pagination` object
    - `total` integer — Total number of campaigns available
    - `limit` integer — Number of campaigns requested per page
    - `offset` integer — Number of campaigns skipped

## Other responses

- `401` — Unauthorized - Invalid or missing authentication.
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/revisions/00b614a7714c/schema)