> ## 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 Call Stats

> Get call statistics for a tenant with optional filters by user, group, direction, and time distribution



## OpenAPI

````yaml https://api.voxo.co/v2/docs/openapi.json post /v2/admin/reporting/calls/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/calls/stats:
    post:
      tags:
        - Reporting - Calls
      summary: Admin Call Stats
      description: >-
        Get call statistics for a tenant with optional filters by user, group,
        direction, and time distribution
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tenantId:
                  type: number
                  exclusiveMinimum: 0
                  description: Tenant ID
                startDate:
                  type: string
                  description: Start date for the report period
                endDate:
                  type: string
                  description: End date for the report period
                direction:
                  description: Call direction filter (IN or OUT)
                  anyOf:
                    - type: string
                      enum:
                        - IN
                    - type: string
                      enum:
                        - OUT
                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
                distribution:
                  description: >-
                    Time distribution grouping (daily, weekly, monthly, or
                    totals)
                  anyOf:
                    - type: string
                      enum:
                        - weekly
                    - type: string
                      enum:
                        - daily
                    - 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
                groups:
                  description: Filter by groups (queue, huntlist, or branch)
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        anyOf:
                          - type: string
                            enum:
                              - queue
                          - type: string
                            enum:
                              - huntlist
                          - type: string
                            enum:
                              - branch
                      id:
                        type: number
                        exclusiveMinimum: 0
                    required:
                      - type
                      - id
              required:
                - tenantId
                - startDate
                - endDate
              additionalProperties: false
      responses:
        '200':
          description: Call statistics or export acknowledgement
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      tenantId:
                        type: number
                        description: Tenant ID
                      results:
                        anyOf:
                          - type: array
                            items:
                              type: object
                              properties:
                                answered:
                                  type: number
                                  description: Number of answered calls
                                unanswered:
                                  type: number
                                  description: Number of unanswered calls
                                transferred:
                                  type: number
                                  description: Number of transferred calls
                                voicemail:
                                  type: number
                                  description: Number of voicemail calls
                                date:
                                  description: Distribution date
                                  type: string
                                distribution:
                                  description: Time distribution label
                                  type: string
                                peerName:
                                  description: User peer name
                                  type: string
                                name:
                                  description: User display name
                                  type: string
                              required:
                                - answered
                                - unanswered
                                - transferred
                                - voicemail
                              additionalProperties: false
                          - type: object
                            properties:
                              answered:
                                type: number
                                description: Number of answered calls
                              unanswered:
                                type: number
                                description: Number of unanswered calls
                              transferred:
                                type: number
                                description: Number of transferred calls
                              voicemail:
                                type: number
                                description: Number of voicemail calls
                              date:
                                description: Distribution date
                                type: string
                              distribution:
                                description: Time distribution label
                                type: string
                              peerName:
                                description: User peer name
                                type: string
                              name:
                                description: User display name
                                type: string
                            required:
                              - answered
                              - unanswered
                              - transferred
                              - voicemail
                            additionalProperties: false
                        description: Call statistics results
                    required:
                      - tenantId
                      - results
                    additionalProperties: false
                    description: Call 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

````