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

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

`GET /campaign/user`

Retrieves campaigns with associated user assignments. Returns campaign data showing which users have access to each campaign for permission management and reporting scope configuration. Supports pagination and filtering.

## Query parameters

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

## Response `200`

Campaigns with user assignments and access permissions

- CampaignUserResponse
  - `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.
  - `campaign_users` User[] — campaign_users. Type: array of object (User).
    - `ct_user_id` integer — Convirza user ID (platform user). Integer. Primary key of ct_user table.
    - `user_ext_id` string — An external identifier set for user. Type: string.
    - `first_name` string, required — The users first name. Type: string.
    - `last_name` string, required — The users last name. Type: string.
    - `user_title` string — The title given to the user. Type: string.
    - `user_status` 'active' | 'inactive' | 'suspended' — user_status. Type: enum (string); Allowed values: active, inactive, suspended.
    - `role_id` integer, required — The user account type set for user. 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.
    - `user_email` string, required — The users e-mail address / login. Type: string.
    - `password` string, password — The password for the user account. Type: string (password).
    - `aliases` string — Comma separated list of user alias. Type: string.
    - `timezone` 'America/Halifax' | 'America/New_York' | 'America/Chicago' | 'America/Denver' | 'America/Phoenix' | 'America/Los_Angeles' | 'utc' — The users timezone. Type: enum (string); Allowed values: America/Halifax, America/New_York, America/Chicago, America/Denver, America/Phoenix, America/Los_Angeles, utc.

## 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/versions/ccf9bbe34f5a/schema)