> ## 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 agent details

> Returns detailed information about a specific telephony agent including their status and team assignments.




## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /report/telephonyAgent/{agentId}
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/telephonyAgent/{agentId}:
    get:
      tags:
        - Report
      summary: Get telephony agent details
      description: >
        Returns detailed information about a specific telephony agent including
        their status and team assignments.
      operationId: getTelephonyAgentDetails
      parameters:
        - name: agentId
          in: path
          required: true
          description: The ID of the telephony agent (user)
          schema:
            type: integer
          example: 3
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Agent ID
                    example: 3
                  name:
                    type: string
                    description: Agent name
                    example: Dennis Sommer
                  callRoutingStatus:
                    type: string
                    enum:
                      - idle
                      - interacting
                      - beingConnected
                      - notResponding
                      - unavailable
                      - offline
                      - acw
                    description: Current telephony routing status
                    example: idle
                  teamIds:
                    type: array
                    items:
                      type: integer
                    description: Array of team IDs the agent belongs to
                    example:
                      - 1
                      - 2
                  channels:
                    type: array
                    items:
                      type: string
                      enum:
                        - email
                        - portal
                        - phone
                        - system
                        - chat
                        - walkIn
                        - letter
                    description: Array of channels the agent is skilled to handle
                    example:
                      - phone
                      - chat
                  liveOverview:
                    type: object
                    description: Real-time statistics for this agent today
                    properties:
                      callsToday:
                        type: integer
                        description: Number of calls handled today
                        example: 13
                      talkTimeSeconds:
                        type: integer
                        description: Total talk time in seconds today
                        example: 1934
                      acwTimeSeconds:
                        type: integer
                        description: Total After Call Work time in seconds today
                        example: 767
                      missed:
                        type: integer
                        description: Number of missed calls today
                        example: 1
                example:
                  id: 3
                  name: Dennis Sommer
                  callRoutingStatus: idle
                  teamIds:
                    - 1
                    - 2
                  channels:
                    - phone
                    - chat
                  liveOverview:
                    callsToday: 13
                    talkTimeSeconds: 1934
                    acwTimeSeconds: 767
                    missed: 1
        '403':
          description: Unauthorized
        '404':
          description: Telephony 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

````