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

# Get telephony AI agent performance metrics

> Returns performance metrics for a specific telephony AI agent over time.
Returns 5 metrics: answered calls, missed calls, service level, average wait time, and average handling time.




## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /report/telephonyAiAgentPerformance/{aiAgentId}
openapi: 3.0.0
info:
  version: '1'
  title: enneo.MIND API
  description: This describes the API of enneo Mind, the main ticketing backend
  contact:
    name: enneo GmbH
    email: richard@enneo.ai
  license:
    name: Proprietary software
    url: https://enneo.ai
servers:
  - url: https://demo.enneo.ai/api/mind
    description: Production server, demo client
  - url: https://main.enneo.dev/api/mind
    description: Development main branch
  - url: http://localhost:8005/api/mind
    description: Local development server
security:
  - bearerAuth:
      - api
  - cookieAuth:
      - api
paths:
  /report/telephonyAiAgentPerformance/{aiAgentId}:
    get:
      tags:
        - Report
      summary: Get telephony AI agent performance metrics
      description: >
        Returns performance metrics for a specific telephony AI agent over time.

        Returns 5 metrics: answered calls, missed calls, service level, average
        wait time, and average handling time.
      operationId: getTelephonyAiAgentPerformance
      parameters:
        - name: aiAgentId
          in: path
          required: true
          description: The ID of the telephony AI agent
          schema:
            type: integer
          example: 5
        - name: lastDays
          in: query
          required: false
          description: Number of days to look back
          schema:
            type: string
            enum:
              - '0'
              - '1'
              - '3'
              - '7'
              - '14'
              - '30'
              - '90'
              - '365'
            default: '7'
          example: '7'
        - name: granularity
          in: query
          required: false
          description: >
            Time bucket size for the time-series data. When omitted, defaults to
            'day' (dd.mm keys, same as before).

            - hour: one bucket per clock-hour (YYYY-MM-DD HH:00 keys); only
            allowed with lastDays ≤ 31

            - day: one bucket per calendar day (dd.mm keys)

            - week: one bucket per ISO week (YYYY-WNN keys)

            - month: one bucket per calendar month (YYYY-MM keys)
          schema:
            type: string
            enum:
              - hour
              - day
              - week
              - month
          example: week
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  answeredCalls:
                    type: object
                    properties:
                      data:
                        type: object
                        additionalProperties:
                          type: object
                        description: Answered calls per day
                        example:
                          '28.11':
                            Answered Calls: 45
                          '29.11':
                            Answered Calls: 52
                      description:
                        type: string
                      filters:
                        type: object
                      summary:
                        type: object
                        properties:
                          total:
                            type: integer
                  missedCalls:
                    type: object
                    properties:
                      data:
                        type: object
                        additionalProperties:
                          type: object
                        description: Missed calls per day
                      description:
                        type: string
                      filters:
                        type: object
                      summary:
                        type: object
                        properties:
                          total:
                            type: integer
                  serviceLevel:
                    type: object
                    properties:
                      data:
                        type: object
                        additionalProperties:
                          type: object
                        description: Service level percentage per day
                      description:
                        type: string
                      filters:
                        type: object
                      summary:
                        type: object
                        properties:
                          average:
                            type: integer
                  averageWaitTime:
                    type: object
                    properties:
                      data:
                        type: object
                        additionalProperties:
                          type: object
                        description: Average wait time in seconds per day
                      description:
                        type: string
                      filters:
                        type: object
                      summary:
                        type: object
                        properties:
                          average:
                            type: integer
                  averageHandlingTime:
                    type: object
                    properties:
                      data:
                        type: object
                        additionalProperties:
                          type: object
                        description: Average handling time in seconds per day
                      description:
                        type: string
                      filters:
                        type: object
                      summary:
                        type: object
                        properties:
                          average:
                            type: integer
                example:
                  answeredCalls:
                    data:
                      '28.11':
                        Answered Calls: 45
                      '29.11':
                        Answered Calls: 52
                    description: >-
                      Number of calls answered by AI per day in the selected
                      period.
                    filters:
                      lastDays: '7'
                    summary:
                      total: 350
                  missedCalls:
                    data:
                      '28.11':
                        Missed Calls: 4
                      '29.11':
                        Missed Calls: 3
                    description: Number of missed calls per day in the selected period.
                    filters:
                      lastDays: '7'
                    summary:
                      total: 28
                  serviceLevel:
                    data:
                      '28.11':
                        Service Level: 92
                      '29.11':
                        Service Level: 95
                    description: >-
                      Service level percentage per day (calls answered within
                      SLA).
                    filters:
                      lastDays: '7'
                    summary:
                      average: 93
                  averageWaitTime:
                    data:
                      '28.11':
                        Average Wait Time: 6
                      '29.11':
                        Average Wait Time: 5
                    description: >-
                      Average wait time in seconds before call was answered by
                      AI per day.
                    filters:
                      lastDays: '7'
                    summary:
                      average: 6
                  averageHandlingTime:
                    data:
                      '28.11':
                        Average Handling Time: 85
                      '29.11':
                        Average Handling Time: 92
                    description: Average handling time in seconds by AI per day.
                    filters:
                      lastDays: '7'
                    summary:
                      average: 88
        '403':
          description: Unauthorized
        '404':
          description: Telephony AI agent not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      description: Data format of Enneo error messages
      properties:
        error:
          type: string
          example: Contract 121 could not be processed
          description: Readable error message that should be shown to the user
        details:
          type: string
          example: >-
            Uncatched null point exception in testFunction() in
            /app/src/file:212
          description: Not easily readable error message that is for the developer
        txId:
          type: string
          example: c916167c94
          description: >-
            Internal transaction id. Useful for debugging. Corresponds to the
            OpenTelemetry trace ID.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-based authentication
      x-scopes:
        api: Full access to the API
    cookieAuth:
      type: apiKey
      in: cookie
      name: connect.sid
      description: Cookie-based authentication
      x-scopes:
        api: Full access to the API

````