Skip to main content
GET
/
v2
/
api
/
dialing-queues
/
current
List current queue numbers
curl --request GET \
  --url https://api.withallo.com/v2/api/dialing-queues/current \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "number_to": "+12125550010",
      "position": 0,
      "created_at": "2026-04-30T10:00:00",
      "updated_at": "2026-04-30T10:00:00",
      "call_start_date": null,
      "call_id": null,
      "routing_result": null,
      "sync_status": "NOT_SYNCED"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 137,
    "total_pages": 7,
    "has_more": true
  },
  "queue": {
    "id": "pdl_2xGh7kLmNpQr",
    "name": "My Queue",
    "creator_id": "usr_abc123",
    "assignee_id": "usr_abc123",
    "voicemail_handling": "NO_SKIP",
    "do_not_disturb": "DISABLED",
    "created_at": "2026-04-30T10:00:00",
    "updated_at": "2026-04-30T10:00:00"
  }
}

​
Pagination

This endpoint follows the standard list contract: data is the array of the current queue’s numbers (ordered by position ascending), alongside a top-level pagination block.
  • page — 1-indexed page number (default 1).
  • size — numbers per page (default 20, max 100).
  • Read pagination (total_count, total_pages, has_more) to page through the full list.
The queue’s own metadata (id, name, voicemail_handling, do_not_disturb, creator/assignee) is returned under the top-level queue key — without the numbers, since those are paginated in data. The queue field stays the same across pages. When the user has no queue, the response is 200 with an empty data array, a zeroed pagination, and no queue key — not a 404.

​
Targeting a teammate’s queue

By default, this returns the queue assigned to the API key owner. To inspect a teammate’s queue, pass either user_id or email as a query parameter. The teammate must belong to the same team as the API key owner.
  • user_id — wins when both are provided. Resolve teammate ids via GET /v2/api/users.
  • email — used only when user_id is absent.
If the resolved user isn’t on your team, the response is 404 ASSIGNEE_NOT_FOUND — the same error is returned whether the user doesn’t exist or isn’t a teammate, so API consumers cannot enumerate users.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
user_id
string

ID of a teammate to read the queue for. Resolve teammate ids via GET /v2/api/users. Wins over email when both are provided.

Example:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

​
email
string<email>

Email of a teammate to read the queue for. Ignored when user_id is also supplied.

Example:

"[email protected]"

​
page
integer
default:1

1-indexed page number for the queue's numbers.

Required range: x >= 1
Example:

1

​
size
integer
default:20

Number of numbers per page (max 100).

Required range: x <= 100
Example:

20

Response

A page of the current queue's numbers, ordered by position. Empty data array with zeroed pagination when the user has no queue.

​
data
object[]
​
queue
object

Power Dialer queue metadata, without its numbers. Returned under the queue key of GET /current; the numbers themselves are the paginated data.

​
pagination
object