---
title: "List contacts in a campaign's call queue"
method: GET
path: "/campaigns/call/{campaignscalllistuuid}/numbers"
tags: ["campaigns"]
---

# List contacts in a campaign's call queue

`GET /campaigns/call/{campaignscalllistuuid}/numbers`

Retrieves the paginated list of phone numbers (contacts) in a campaign's call queue. Each entry includes the phone number, associated metadata (`json_csv_infos`: firstname, lastname, company, custom fields), call status (pending, called, answered, failed), retry count, and call timestamps. Results are paginated using `limit_count` and `limit_offset`.

**Permission:** No specific permission required. A valid API key is sufficient.

## Path parameters

- `campaignscalllistuuid` string, uuid, required

## Query parameters

- `limit_count` integer
- `limit_offset` integer

## Response `200`

Successful operation

- CampaignCalllistNumbersList
  - `campaign_calllist_uuid` string, uuid — Unique identifier for the object
  - `team_id` integer — Team identifier
  - `user_id` integer — User identifier
  - `name` string — The name of the campaign CALL List
  - `campaign_tags` integer[] — tags of the campaign
  - `users_list` integer[] — The list of users
  - `groups_list` integer[] — The list of groups
  - `fifo_left_to_call` integer — The number of numbers left to call
  - `update_date` string, date-time
  - `creation_date` string, date-time
  - `deletion_date` string, date-time
  - `max_retry` integer — The max retry attempts for numbers in the campaign CALL List
  - `retry_time` integer — Optional time in seconds to wait before retrying a number
  - `ivr_id` integer — Optional id of the ivr
  - `start_date` string, date-time — Optional start date of the campaign
  - `campaign_count_numbers` integer
  - `campaign_count_active_numbers` integer
  - `campaign_count_users` integer
  - `campaign_count_groups` integer
  - `is_private` boolean — true if the campaign call is private
  - `is_running` boolean — true if the campaign call is currently running
  - `stop_reason` string — the reason why the campaign call has been stopped
  - `script` CampaignCallScript
    - `script_uuid` string, uuid — The identifier of the script
    - `generic_uuid` string, uuid
    - `name` string — The name of the script
    - `data` string
    - `is_enabled` boolean — true if the script is enabled
  - `limit_offset_setted` integer
  - `limit_count_setted` integer
  - `total_numbers_list_count` integer
  - `numbers_list` CampaignCalllistNumbers[], nullable — The list of campaign calllist numbers
    - `number_id` integer
    - `campaign_calllist_uuid` string, uuid
    - `to_number` integer
    - `to_number_format` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean
    - `retry` integer
    - `max_retry` integer
    - `done_date` string, date-time
    - `creation_date` string, date-time
    - `scheduled_callback_date` string, date-time
    - `call_by_user_id` integer
    - `call_id` integer
    - `json_csv_infos` string, json — Contains data related to the number. json_csv_infos must follow the schema: {"company": "", "firstname": "", "lastname": "", "social_data": [{"optionalField": ""}, ...]} The fields "company", "firstname", "lastname" and "social_data" are required. The field "social_data" is an array of objects, each containing a key-value pair of type string. All numbers' json_csv_infos must have the same fields in "social_data".
  - `numbers_list_len` integer

## Other responses

- `400` — Invalid ID supplied
- `401` — Token unauthorized
- `404` — Group not found
- `500` — Internal server error

---

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