Allo

List current queue numbers

Returns the numbers in the Power Dialer queue currently assigned to the authenticated user, paginated and ordered by position ascending. data is the list of…

GET/v2/api/dialing-queues/current

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.

Reading call_status

Each number in data carries a call_status field: one status per row, derived from the call placed for it. Use it instead of combining routing_result, not_reached_destination_reason and detected_outbound_voicemail yourself.

ValueMeaning
QUEUEDNo call has been placed yet, or the call is still in progress.
SKIPPEDThe number was skipped in the Power Dialer and no call was placed. If a call is placed for it later, the status follows that call.
VOICEMAILThe call reached a voicemail box.
CONNECTEDThe call was answered at route level (routing_result is ANSWERED) no voicemail was detected and no not_reached_destination_reason is set.
TRANSFERREDThe call was transferred.
BUSYThe destination was busy.
WRONG_NUMBERThe destination is not in service.
NO_ANSWERThe call ended without an answer: declined, unavailable, ring timeout, network error, or any other final route status (failed, blocked, closed, handled by call flow).

CONNECTED means the call was answered at route level, not that a conversation took place, so it can over-report real conversations.

A number whose call is in progress shows QUEUED. Counting QUEUED numbers can therefore differ from the remaining count while a call is running.

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.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Query parameters

user_idstring

ID of a teammate to read the queue for. Resolve teammate ids via [GET /v2/api/users](/en/v2/api-reference/users/list-users). Wins over email when both are provided.

emailstring<email>

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

pageinteger

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

sizeinteger

Number of numbers per page (max 100).

Responses

200A page of the current queue's numbers, ordered by position. Empty data array with zeroed pagination when the user has no queue.
dataobject[]
12 fields
number_tostring

E.164 destination phone number

positioninteger

Order within the queue (0-based)

created_atstring<date-time>
updated_atstring<date-time>
call_start_datestring<date-time> | null

When the user started calling this entry. null if the entry is still unassigned.

call_idstring | null

ID of the call placed for this entry (cll-*). null until a call is placed.

routing_resultenum<string>

Final routing outcome of the call placed for this entry.

FAILEDRECEIVEDBLOCKEDANSWEREDTRANSFERRED_BLANDTRANSFERRED_ELEVEN_LABSTRANSFERRED_EXTERNALFAILED_EXTERNALVOICEMAILCLOSED

sync_statusenum<string>

State of contact creation/sync for this entry.

NOT_SYNCEDPROCESSINGSYNCED

detected_outbound_voicemailboolean | null

Whether the call was detected as having reached a voicemail box.

not_reached_destination_reasonenum<string>

Why the call did not reach the contact (only set when applicable).

BUSYCALLEE_TEMPORARILY_UNAVAILABLERING_TIMEOUTNOT_IN_SERVICEDECLINEDNETWORK_ERROR

voicemail_leftboolean | null

Whether the user left a voicemail on this entry.

call_statusenum<string>

Status of this entry, derived from the call placed for it. QUEUED: no call yet, or the call is still in progress. SKIPPED: skipped in the Power Dialer with no call placed (if a call is placed for it later, the status follows that call). VOICEMAIL: the call reached a voicemail box. CONNECTED: the call was answered at route level (routing_result is ANSWERED), no voicemail was detected and no not_reached_destination_reason is set; this can over-report a real conversation. TRANSFERRED: the call was transferred. BUSY: the destination was busy. WRONG_NUMBER: the destination is not in service. NO_ANSWER: the call ended without an answer, including the other not_reached_destination_reason values and any other final route status (failed, blocked, closed, handled by call flow).

QUEUEDSKIPPEDVOICEMAILCONNECTEDTRANSFERREDNO_ANSWERBUSYWRONG_NUMBER

queueobject

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

8 fields
idstring

Unique queue identifier (KSUID with pdl prefix)

namestring | null

Display name of the queue

creator_idstring

User ID of the queue creator.

assignee_idstring | null

User ID of the user expected to run the queue.

voicemail_handlingenum<string>

How the Power Dialer reacts when the call lands in voicemail.

SKIPNO_SKIP

do_not_disturbenum<string>

When ENABLED, incoming calls are silenced while the queue is being run.

ENABLEDDISABLED

created_atstring<date-time>
updated_atstring<date-time>
paginationobject
5 fields
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
401
404Assignee not found
errorobject
6 fields
typestring
codestring
messagestring
retryableboolean
request_idstring
retry_after_secondsinteger | null
429