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

# List Call Queue

> Paginated list of contacts queued for outbound calls across the authenticated user's company. Supports filtering by status and search by contact name or phone.



## OpenAPI

````yaml GET /agent/queue/
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /agent/queue/:
    get:
      tags:
        - agent
      summary: List Call Queue
      description: >-
        Paginated list of contacts queued for outbound calls across the
        authenticated user's company. Supports filtering by status and search by
        contact name or phone.
      operationId: agent_queue_retrieve
      parameters:
        - in: header
          name: X-User-Timezone
          schema:
            type: string
          description: IANA timezone for formatting `scheduled_at`. Defaults to UTC.
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: 1-indexed page (10 items per page).
        - in: query
          name: search
          schema:
            type: string
          description: >-
            Case-insensitive partial match against contact full name or phone
            number.
        - in: query
          name: status
          schema:
            type: string
            default: all
          description: >-
            `all` | `scheduled` | `insufficient_funds` | any specific queue
            status (e.g. `waiting`, `paused`, `complete`).
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallQueueListResponse'
          description: Paginated queue page.
      security:
        - jwtAuth: []
        - {}
components:
  schemas:
    CallQueueListResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/CallQueueItem'
        total:
          type: integer
      required:
        - results
        - total
    CallQueueItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
        agent_name:
          type: string
        agent_id:
          type: string
          format: uuid
        user_name:
          type: string
        phone_number:
          type: string
        agent_number:
          type: string
          nullable: true
        status:
          type: string
        scheduled_at:
          type: string
          nullable: true
          description: Pre-formatted (`DD/MM/YYYY • hh:mma`) in `X-User-Timezone`.
      required:
        - agent_id
        - agent_name
        - agent_number
        - id
        - phone_number
        - scheduled_at
        - status
        - user_name
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````