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

# List Campaigns

`GET /api/v1/campaigns/`

## Request

- Base URL: `https://api.ravan.ai`
- URL: `https://api.ravan.ai/api/v1/campaigns/`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `limit` integer
- `offset` integer
- `status` string

## Response `200`

Successful response

- ListCampaignsResponse
  - `success` boolean
  - `message` string
  - `data` Campaign[]
    - `id` string: Campaign UUID
    - `organization_id` string: Organization UUID
    - `name` string: Campaign name
    - `agent_id` string: Assigned agent UUID
    - `phone_number_id` string: Phone number UUID
    - `from_phone_number` string: Caller ID
    - `status` string: Status: draft, running, paused, completed
    - `execution_status` string: Execution state
    - `schedule` CampaignSchedule
      - `start` string: Execution start (ISO 8601, server-set)
      - `end` string: Execution end (ISO 8601, server-set)
      - `window_start` string: Daily call window start, e.g. 09:00
      - `window_end` string: Daily call window end, e.g. 18:00
      - `window_days` integer[]: Days of week (1=Mon ... 7=Sun)
      - `timezone` string: IANA timezone, e.g. Asia/Kolkata
      - `max_concurrent` integer: Max simultaneous calls
      - `retry_attempts` integer: Max retry count per contact
      - `retry_gap_min` integer: Minutes between retries
    - `contact_stats` CampaignStats
      - `total` integer: Total contacts in campaign
      - `contacted` integer: Contacts that were reached
      - `successful` integer: Successful calls
      - `failed` integer: Failed calls
      - `no_answer` integer: No answer calls
      - `pending` integer: Awaiting first attempt
      - `in_progress` integer: Currently being called
    - `started_at` string: Execution start timestamp (ISO 8601)
    - `completed_at` string: Execution end timestamp (ISO 8601)
    - `created_at` string: Creation timestamp
    - `updated_at` string: Last update timestamp
  - `meta` Meta
    - `total` integer: Total number of records
    - `limit` integer: Page size limit
    - `offset` integer: Pagination offset

## Changes

- **2026-11-03** `53e6f393f46e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ravan/apis/agni-api/changes/api/v1/campaigns/get.md)

---

[API](https://skmtc.dev/ravan/apis/agni-api.md) - [All operations](https://skmtc.dev/ravan/apis/agni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ravan/apis/agni-api/revisions/53e6f393f46e?raw)