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

# Admin Queue Stats

> Get queue statistics with optional filters by user, time distribution, and call outcome



## OpenAPI

````yaml https://api.voxo.co/v2/docs/openapi.json post /v2/admin/reporting/queues/stats
openapi: 3.1.0
info:
  title: VOXO API
  description: VOXO Communication Platform API
  version: 2.0.0
servers:
  - url: https://api.voxo.co
security:
  - bearerAuth: []
paths:
  /v2/admin/reporting/queues/stats:
    post:
      tags:
        - Reporting - Queues
      summary: Admin Queue Stats
      description: >-
        Get queue statistics with optional filters by user, time distribution,
        and call outcome
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                queueId:
                  type: array
                  items:
                    type: number
                    exclusiveMinimum: 0
                  description: Queue IDs to include in the report
                startDate:
                  type: string
                  description: Start date for the report period
                endDate:
                  type: string
                  description: End date for the report period
                distribution:
                  description: >-
                    Time distribution grouping (daily, weekly, hourly, monthly,
                    or totals)
                  anyOf:
                    - type: string
                      enum:
                        - weekly
                    - type: string
                      enum:
                        - daily
                    - type: string
                      enum:
                        - hourly
                    - type: string
                      enum:
                        - monthly
                    - type: string
                      enum:
                        - totals
                users:
                  description: Filter by user peer names, or 'ALL' for all users
                  anyOf:
                    - type: array
                      items:
                        type: string
                    - type: string
                      enum:
                        - ALL
                tag:
                  description: Filter by call tags
                  minItems: 1
                  type: array
                  items:
                    type: string
                callOutcome:
                  description: Filter by call outcome IDs
                  minItems: 1
                  type: array
                  items:
                    type: number
                reportType:
                  description: Report type (Scheduled, Export, or Live)
                  anyOf:
                    - type: string
                      enum:
                        - Scheduled
                    - type: string
                      enum:
                        - Export
                    - type: string
                      enum:
                        - Live
              required:
                - queueId
                - startDate
                - endDate
              additionalProperties: false
      responses:
        '200':
          description: Queue statistics or export acknowledgement
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      queueIds:
                        type: array
                        items:
                          type: number
                        description: Queue IDs included
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              description: Queue ID (totals by queue)
                              type: number
                            queueId:
                              description: Queue ID
                              type: number
                            queueName:
                              description: Queue name
                              type: string
                            totalInbound:
                              description: Total inbound calls
                              type: number
                            inboundAnswered:
                              type: number
                              description: Inbound calls answered
                            answeredUnder30:
                              description: Calls answered under 30s
                              type: number
                            talkTime:
                              type: number
                              description: Total talk time in seconds
                            ringTime:
                              type: number
                              description: Total ring time in seconds
                            ringNoAnswer:
                              description: Ring no answer count
                              type: number
                            noAnswerRingTime:
                              description: No answer ring time
                              type: number
                            waitTime:
                              type: number
                              description: Total wait time in seconds
                            minWaitTime:
                              description: Minimum wait time
                              anyOf:
                                - type: number
                                - type: 'null'
                            maxWaitTime:
                              description: Maximum wait time
                              type: number
                            outbound:
                              type: number
                              description: Outbound calls
                            totalOutbound:
                              description: Total outbound calls
                              type: number
                            outboundTalkTime:
                              type: number
                              description: Outbound talk time in seconds
                            exitTimeout:
                              type: number
                              description: Calls exited by timeout
                            exitKeypress:
                              type: number
                              description: Calls exited by keypress
                            abandons:
                              type: number
                              description: Abandoned calls
                            abandonsUnder10:
                              type: number
                              description: Calls abandoned under 10s
                            abandonWaitTime:
                              description: Abandon wait time in seconds
                              type: number
                            abandonMin:
                              description: Minimum abandon time
                              anyOf:
                                - type: number
                                - type: 'null'
                            abandonMax:
                              description: Maximum abandon time
                              type: number
                            abandonsUnder30:
                              description: Calls abandoned under 30s
                              type: number
                            totalCallbacks:
                              type: number
                              description: Total callback attempts
                            successfulCallbacks:
                              type: number
                              description: Successful callbacks
                            failedCallbacks:
                              type: number
                              description: Failed callbacks
                            ASA:
                              description: Average speed of answer
                              type: number
                            SLA:
                              description: Service level agreement percentage
                              type: number
                            distribution:
                              description: Time distribution label
                              type: string
                            date:
                              description: Distribution date
                              type: string
                            peerName:
                              description: User peer name
                              anyOf:
                                - type: string
                                - type: 'null'
                            name:
                              description: Agent display name
                              type: string
                          required:
                            - inboundAnswered
                            - talkTime
                            - ringTime
                            - waitTime
                            - outbound
                            - outboundTalkTime
                            - exitTimeout
                            - exitKeypress
                            - abandons
                            - abandonsUnder10
                            - totalCallbacks
                            - successfulCallbacks
                            - failedCallbacks
                          additionalProperties: false
                        description: Queue statistics results
                    required:
                      - queueIds
                      - results
                    additionalProperties: false
                    description: Queue statistics
                  - type: object
                    properties:
                      message:
                        type: string
                        description: Status message
                      code:
                        type: number
                        description: Status code
                    required:
                      - message
                      - code
                    additionalProperties: false
                    description: Export acknowledgement
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````