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

> Get paginated queue event logs with optional filters



## OpenAPI

````yaml https://api.voxo.co/v2/docs/openapi.json post /v2/admin/reporting/queues/logs
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/logs:
    post:
      tags:
        - Reporting - Queues
      summary: Admin Queue Logs
      description: Get paginated queue event logs with optional filters
      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
                events:
                  description: Filter by queue event types
                  type: array
                  items:
                    anyOf:
                      - type: string
                        enum:
                          - AGENT_COMPLETE
                      - type: string
                        enum:
                          - AGENT_CONNECT
                      - type: string
                        enum:
                          - AGENT_OFFDUTY
                      - type: string
                        enum:
                          - AGENT_ONDUTY
                      - type: string
                        enum:
                          - AGENT_ENABLE_DND
                      - type: string
                        enum:
                          - AGENT_DISABLE_DND
                      - type: string
                        enum:
                          - AGENT_RING_NOANSWER
                      - type: string
                        enum:
                          - QUEUE_CALLER_JOIN
                      - type: string
                        enum:
                          - QUEUE_CALLER_WITHDRAW
                      - type: string
                        enum:
                          - QUEUE_CALLER_JOIN
                      - type: string
                        enum:
                          - QUEUE_CALLER_TIMEOUT
                      - type: string
                        enum:
                          - QUEUE_CALLER_EXITWITHKEY
                      - type: string
                        enum:
                          - QUEUE_CALLER_ABANDONED
                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
                callId:
                  description: Filter by specific call ID
                  type: string
                recordsPerPage:
                  description: Number of records per page
                  type: number
                page:
                  description: Page number
                  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 logs or export acknowledgement
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      queueIds:
                        type: array
                        items:
                          type: number
                        description: Queue IDs included
                      records:
                        type: array
                        items:
                          type: object
                          properties:
                            callId:
                              type: string
                              description: Call ID
                            event:
                              type: string
                              description: Queue event type
                            queueId:
                              description: Queue ID
                              type: number
                            queueName:
                              description: Queue name
                              type: string
                            cidNum:
                              type: string
                              description: Caller ID number
                            cidName:
                              type: string
                              description: Caller ID name
                            peerName:
                              description: Agent peer name
                              anyOf:
                                - type: string
                                - type: 'null'
                            name:
                              description: Agent display name
                              anyOf:
                                - type: string
                                - type: 'null'
                            time:
                              type: string
                              description: Event time
                            waitTime:
                              description: Wait time in seconds
                              type: number
                            talkTime:
                              description: Talk time in seconds
                              type: number
                            tag:
                              description: Queue event tag
                              anyOf:
                                - type: string
                                - type: 'null'
                            offDutyReason:
                              description: Off duty reason
                              anyOf:
                                - type: string
                                - type: 'null'
                            exitKey:
                              description: Exit key used
                              anyOf:
                                - type: string
                                - type: 'null'
                            ringTime:
                              description: Ring time in seconds
                              type: number
                          required:
                            - callId
                            - event
                            - queueId
                            - time
                          additionalProperties: false
                        description: Queue log events
                      total:
                        type: number
                        description: Total matching records
                      page:
                        type: number
                        description: Current page number
                      maxPage:
                        type: number
                        description: Maximum page number
                    required:
                      - queueIds
                      - records
                      - total
                      - page
                      - maxPage
                    additionalProperties: false
                    description: Paginated queue logs
                  - 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

````