> ## 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.

# Lister les numeros de la file courante

> 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

Cet endpoint suit le contrat de liste standard : `data` est le tableau des numeros de la file courante (tries par `position` croissante), accompagne d'un bloc `pagination` de premier niveau.

* `page` — numero de page (commence a 1, defaut `1`).
* `size` — nombre de numeros par page (defaut `20`, max `100`).
* Lisez `pagination` (`total_count`, `total_pages`, `has_more`) pour parcourir la liste complete.

Les metadonnees de la file (id, nom, `voicemail_handling`, `do_not_disturb`, createur/assigne) sont retournees sous la cle de premier niveau `queue` — sans les numeros, puisque ceux-ci sont pagines dans `data`. Le champ `queue` reste identique d'une page a l'autre.

Quand l'utilisateur n'a pas de file, la reponse est `200` avec un tableau `data` vide, un `pagination` a zero et aucune cle `queue` — pas une erreur `404`.

## Cibler la file d'un coequipier

Par defaut, cet endpoint retourne la file assignee au proprietaire de la cle API. Pour inspecter la file d'un coequipier, passez `user_id` ou `email` en **query parameter**. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.

* `user_id` — l'emporte quand les deux sont fournis. Resolvez les ids des coequipiers via [`GET /v2/api/users`](/fr/v2/api-reference/users/list-users).
* `email` — utilise uniquement quand `user_id` est absent.

Si l'utilisateur resolu n'est pas dans votre equipe, la reponse est `404 ASSIGNEE_NOT_FOUND` — la meme erreur est renvoyee que l'utilisateur n'existe pas ou ne soit pas un coequipier, afin que les consommateurs de l'API ne puissent pas enumerer les utilisateurs.


## 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 configurations to receive real-time notifications about
      events in your Allo account. Each webhook is associated with a specific
      Allo phone number.
  - 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: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12
              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

````