---
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`

## Request

- Base URL: `https://public-api.ringover.com/v2`
- URL: `https://public-api.ringover.com/v2/campaigns/call/{campaignscalllistuuid}/numbers`
- Auth: API key in header `Authorization`

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

## Changes

- **2025-11-20** `d92d55716cc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ringover/apis/ringover-public-api/changes/campaigns/call/:campaignscalllistuuid/numbers/get.md)

---

[API](https://skmtc.dev/ringover/apis/ringover-public-api.md) - [All operations](https://skmtc.dev/ringover/apis/ringover-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringover/apis/ringover-public-api/revisions/645bfcebdd56?raw)