> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 numbers (use `page`/`size` and read `pagination` to page through them); the `queue` key carries the queue's metadata (id, name, settings) without its numbers. To target a teammate's queue, pass either `user_id` or `email` as a query parameter (`user_id` wins when both are sent); the target must belong to the same team as the API key owner. When the user has no queue, the response is `200` with an empty `data` array, a zeroed `pagination`, and no `queue` (not a `404`).

## 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`](/en/v2/api-reference/users/list-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.


## OpenAPI

````yaml GET /v2/api/dialing-queues/current
openapi: 3.0.3
info:
  title: Allo API
  description: >-
    Allo API provides programmatic access to your Allo account, allowing you to
    manage webhooks, retrieve calls and contacts, and send SMS messages.


    All requests to `/v1/api/**` endpoints automatically go through quota
    checking and scope validation.
  version: 1.0.0
  contact:
    name: Allo Support
servers:
  - url: https://api.withallo.com
    description: Production server
security: []
tags:
  - name: Summary Templates
    description: >-
      Manage call summary templates that control how AI-generated call summaries
      are structured for your team.
  - name: Webhooks
    description: >-
      Manage webhook endpoints to receive real-time notifications about events
      in your Allo account. Each endpoint subscribes to one or more event topics
      and is verified with a signing secret.
  - name: Calls
    description: >-
      Retrieve and search call records with filtering and pagination. Filter
      calls by your Allo phone number.
  - name: Contacts
    description: >-
      Search and retrieve contact information with sorting and pagination.
      Includes engagement level tracking.
  - name: SMS
    description: Send SMS messages to phone numbers using your Allo numbers.
  - name: Phone Numbers
    description: Retrieve information about your Allo phone numbers.
  - name: Analytics
    description: Pre-computed call metrics, team performance, and outbound dial funnel
  - name: CRM
    description: Manage people, companies, and deals in your CRM.
paths:
  /v2/api/dialing-queues/current:
    get:
      tags:
        - Power Dialer
      summary: List current queue numbers
      description: >-
        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 numbers (use `page`/`size` and read `pagination`
        to page through them); the `queue` key carries the queue's metadata (id,
        name, settings) without its numbers. To target a teammate's queue, pass
        either `user_id` or `email` as a query parameter (`user_id` wins when
        both are sent); the target must belong to the same team as the API key
        owner. When the user has no queue, the response is `200` with an empty
        `data` array, a zeroed `pagination`, and no `queue` (not a `404`).
      operationId: getCurrentDialingQueue
      parameters:
        - name: user_id
          in: query
          required: false
          description: >-
            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.
          schema:
            type: string
            example: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220
        - name: email
          in: query
          required: false
          description: >-
            Email of a teammate to read the queue for. Ignored when `user_id` is
            also supplied.
          schema:
            type: string
            format: email
            example: teammate@acme.com
        - name: page
          in: query
          required: false
          description: 1-indexed page number for the queue's `numbers`.
          schema:
            type: integer
            default: 1
            minimum: 1
            example: 1
        - name: size
          in: query
          required: false
          description: Number of `numbers` per page (max 100).
          schema:
            type: integer
            default: 20
            maximum: 100
            example: 20
      responses:
        '200':
          description: >-
            A page of the current queue's numbers, ordered by position. Empty
            `data` array with zeroed `pagination` when the user has no queue.
          content:
            application/json:
              schema:
                allOf:
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/QueueNumber'
                      queue:
                        $ref: '#/components/schemas/DialingQueueMeta'
                  - $ref: '#/components/schemas/PaginatedResponse'
              example:
                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'
        '401':
          $ref: '#/components/responses/ApiUnauthorized'
        '404':
          description: Assignee not found
          content:
            application/json:
              schema:
                $ref: 9222bccd-ab29-488f-a739-261229646138
              examples:
                assignee_not_found:
                  summary: user_id or email does not match a teammate
                  value:
                    error:
                      type: not_found_error
                      code: ASSIGNEE_NOT_FOUND
                      message: >-
                        No team member found for the provided 'user_id' or
                        'email'.
                      retryable: false
                      suggestion: >-
                        List your teammates with GET /v2/api/users and use one
                        of their ids as 'user_id', or pass a team-member email.
        '429':
          $ref: '#/components/responses/ApiRateLimited'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    QueueNumber:
      type: object
      description: A phone number entry in a Power Dialer queue
      properties:
        number_to:
          type: string
          description: E.164 destination phone number
        position:
          type: integer
          description: Order within the queue (0-based)
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        call_start_date:
          type: string
          format: date-time
          nullable: true
          description: >-
            When the user started calling this entry. `null` if the entry is
            still unassigned.
        call_id:
          type: string
          nullable: true
          description: >-
            ID of the call placed for this entry (`cll-*`). `null` until a call
            is placed.
        routing_result:
          type: string
          nullable: true
          enum:
            - FAILED
            - RECEIVED
            - BLOCKED
            - ANSWERED
            - TRANSFERRED_BLAND
            - TRANSFERRED_ELEVEN_LABS
            - TRANSFERRED_EXTERNAL
            - FAILED_EXTERNAL
            - VOICEMAIL
            - CLOSED
          description: Final routing outcome of the call placed for this entry.
        sync_status:
          type: string
          enum:
            - NOT_SYNCED
            - PROCESSING
            - SYNCED
          description: State of contact creation/sync for this entry.
        detected_outbound_voicemail:
          type: boolean
          nullable: true
          description: Whether the call was detected as having reached a voicemail box.
        not_reached_destination_reason:
          type: string
          nullable: true
          enum:
            - BUSY
            - CALLEE_TEMPORARILY_UNAVAILABLE
            - RING_TIMEOUT
            - NOT_IN_SERVICE
            - DECLINED
            - NETWORK_ERROR
          description: Why the call did not reach the contact (only set when applicable).
        voicemail_left:
          type: boolean
          nullable: true
          description: Whether the user left a voicemail on this entry.
    DialingQueueMeta:
      type: object
      description: >-
        Power Dialer queue metadata, without its numbers. Returned under the
        `queue` key of `GET /current`; the numbers themselves are the paginated
        `data`.
      properties:
        id:
          type: string
          description: Unique queue identifier (KSUID with `pdl` prefix)
        name:
          type: string
          nullable: true
          description: Display name of the queue
        creator_id:
          type: string
          description: User ID of the queue creator.
        assignee_id:
          type: string
          nullable: true
          description: User ID of the user expected to run the queue.
        voicemail_handling:
          type: string
          enum:
            - SKIP
            - NO_SKIP
          description: How the Power Dialer reacts when the call lands in voicemail.
        do_not_disturb:
          type: string
          enum:
            - ENABLED
            - DISABLED
          description: >-
            When `ENABLED`, incoming calls are silenced while the queue is being
            run.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    PaginatedResponse:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
    Pagination:
      type: object
      properties:
        page:
          type: integer
        size:
          type: integer
        total_count:
          type: integer
        total_pages:
          type: integer
        has_more:
          type: boolean
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
            request_id:
              type: string
            retry_after_seconds:
              type: integer
              nullable: true
  responses:
    ApiUnauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiRateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````