---
title: "List of campaigns belonging to the user group and all children"
method: GET
path: "/campaign/list"
tags: ["campaign"]
---

# List of campaigns belonging to the user group and all children

`GET /campaign/list`

Retrieves campaigns accessible within the user's organizational hierarchy. Returns campaign metadata including names, status, tracking numbers, and routing configurations. Supports pagination and filtering.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string[]

## Response `200`

Campaign records with metadata and configuration summaries

- CampaignListResponse[]
  - `campaign_id` integer — Unique identifier for the campaign this call was attributed to. Integer.
  - `campaign_name` string, required — Human-readable campaign name. String.
  - `campaign_ext_id` string — Customer-provided external identifier for the campaign. Integer.
  - `campaign_status` 'active' | 'inactive' | 'suspended' — The current status of the campaign. Type: enum (string); Allowed values: active, inactive, suspended.
  - `campaign_created` string, date-time — The date and time of when the campaign record was created. Type: string (date-time).
  - `campaign_modified` string, date-time — A date and time stamp of the last time anything was modified on campaign. Type: string (date-time).
  - `campaign_start_date` string, date-time, required — The date and time that the campaign is activated. Type: string (date-time).
  - `campaign_end_date` string, date-time — The date and time at which the campaign will end. Type: string (date-time).
  - `campaign_owner_user_id` integer, required — The unique ID of the user that is the owner of the campaign. Type: integer (int32).
  - `group_id` integer, required — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.
  - `referral_service` object — Referral Service.
    - `referral_enabled` boolean, required — This enables/disables referral service. Type: boolean.
    - `ringto_phone_number` integer — Phone number in referral recording if campaign is in referral state. Type: integer.
  - `owner_fname` string — The first name of the campaign owner. Type: string.
  - `owner_lname` string — The last name of the campaign owner. Type: string.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/revisions/ccf9bbe34f5a/schema)