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

> Returns detailed information about a specific telephony line (subchannel) including voicebot configuration and connected phone numbers.




## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /report/telephonyLine/{lineId}
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/telephonyLine/{lineId}:
    get:
      tags:
        - Report
      summary: Get telephony line details
      description: >
        Returns detailed information about a specific telephony line
        (subchannel) including voicebot configuration and connected phone
        numbers.
      operationId: getTelephonyLineDetails
      parameters:
        - name: lineId
          in: path
          required: true
          description: The ID of the telephony line (subchannel)
          schema:
            type: integer
          example: 9
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: Unique identifier for the telephony line
                        example: 9
                      name:
                        type: string
                        description: Internal name of the line
                        example: ACD Bot-to-Agent
                      status:
                        type: string
                        enum:
                          - active
                          - disabled
                          - error
                        description: Current status of the line
                        example: active
                      liveOverview:
                        type: object
                        description: Real-time statistics for this line
                        properties:
                          inQueue:
                            type: integer
                            description: Number of calls currently waiting in queue
                            example: 3
                          ongoingAiCalls:
                            type: integer
                            description: Number of ongoing AI/bot calls
                            example: 4
                          agentsConnected:
                            type: integer
                            description: Number of agents currently connected (not offline)
                            example: 3
                      phoneNumbers:
                        type: object
                        description: Connected phone numbers
                        properties:
                          inbound:
                            type: array
                            description: Inbound phone numbers for this line
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: Phone number ID
                                  example: 0dfe1e36-8145-4940-b41b-f4156447d2be
                                number:
                                  type: string
                                  description: Phone number in E.164 format
                                  example: '+4930754358631'
                          outbound:
                            type: object
                            nullable: true
                            description: Outbound phone number for this line
                            properties:
                              id:
                                type: string
                                description: Phone number ID
                                example: 0dfe1e36-8145-4940-b41b-f4156447d2be
                              number:
                                type: string
                                description: Phone number in E.164 format
                                example: '+4930754358631'
                      liveCalls:
                        type: array
                        description: >-
                          Currently active calls on this line. Passthrough from
                          ACD; empty until ACD MR 2 ships.
                        items:
                          type: object
                          required:
                            - callId
                            - from
                            - state
                            - durationSeconds
                          properties:
                            callId:
                              type: string
                              description: Unique call identifier
                              example: 550e8400-e29b-41d4-a716-446655440000
                            ticketId:
                              type: integer
                              description: Associated ticket ID (omitted if not yet linked)
                              example: 12345
                            from:
                              type: string
                              description: Caller phone number
                              example: '+4930754358631'
                            state:
                              type: string
                              enum:
                                - waiting
                                - bot
                                - human
                                - forwarded
                              description: Current call state
                              example: human
                            agentUserId:
                              type: integer
                              description: >-
                                ID of the connected agent (omitted if not
                                applicable)
                              example: 42
                            agentName:
                              type: string
                              description: >-
                                Name of the connected agent (omitted if not
                                applicable)
                              example: Jenny Kaspar
                            waitSeconds:
                              type: integer
                              description: >-
                                Seconds spent waiting in queue (present only
                                when state is waiting)
                              example: 12
                            durationSeconds:
                              type: integer
                              description: >-
                                Total call duration in seconds since call
                                started
                              example: 30
                  description:
                    type: string
                    description: Description of what this report shows
                    example: >-
                      Detailed information about a specific telephony line
                      including voicebot configuration and connected phone
                      numbers.
                  filters:
                    type: object
                    description: Filters applied to this report
                example:
                  data:
                    id: 11
                    name: ACD Bot-to-Agent
                    status: active
                    liveOverview:
                      inQueue: 3
                      ongoingAiCalls: 4
                      agentsConnected: 3
                    phoneNumbers:
                      inbound:
                        - id: 0dfe1e36-8145-4940-b41b-f4156447d2be
                          number: '+4930754358631'
                      outbound:
                        id: 0dfe1e36-8145-4940-b41b-f4156447d2be
                        number: '+4930754358631'
                    liveCalls:
                      - callId: 550e8400-e29b-41d4-a716-446655440000
                        ticketId: 12345
                        from: '+4930754358631'
                        state: human
                        agentUserId: 42
                        agentName: Jenny Kaspar
                        durationSeconds: 30
                  description: >-
                    Detailed information about a specific telephony line
                    including voicebot configuration and connected phone
                    numbers.
                  filters: []
        '403':
          description: Unauthorized
        '404':
          description: Telephony line 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

````