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

# Get Agent

> Retrieves details of a specific agent by its ID



## OpenAPI

````yaml /api-reference/openapi.json get /api/agents/{agent_id}
openapi: 3.1.0
info:
  title: Ello.AI API
  description: API for managing agents and calls in Ello.AI
  version: 1.0.0
servers:
  - url: https://api.getello.ai/
security: []
paths:
  /api/agents/{agent_id}:
    get:
      tags:
        - Agents
      summary: Get Agent
      description: Retrieves details of a specific agent by its ID
      operationId: getAgentById
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Agents retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  message:
                    type: string
                    example: Agents retrieved successfully
                  data:
                    type: array
                    items:
                      type: object
                    example:
                      - _id: 69cf92ec643b415327cab0ae
                        workspaceId: 6970c2f3948cfbce1932d99d
                        userId: 6970c2f3948cfbce1932d99c
                        name: My Hybrid Agent2
                        type: hybrid
                        category:
                          - general
                        description: AI assistant for voice calls
                        image: '1'
                        features: []
                        popularity: 0
                        voiceConfig:
                          provider: elevenlabs
                          model: eleven_flash_v2_5
                          voiceId: pwMBn0SsmN1220Aorv15
                          language: en-IN
                          patienceLevel: 1
                          speed: 1
                          pitch: 1
                          latency: 0.5
                          stability: 0.5
                          styleExaggeration: 0
                          similarity: 0.8
                          numberOfWords: 0
                          voiceSeconds: 0.2
                          backOfSeconds: 0.1
                        aiModel:
                          provider: openai
                          model: gpt-4o
                          temperature: 0.7
                          maxTokens: 200
                        llmConfig:
                          provider: openai_responses
                          model: gpt-4o
                          temperature: 0.7
                          maxTokens: 200
                        sttConfig:
                          utterance_end_ms: 1500
                          on_punctuation_second: 0
                          vadEnabled: false
                          ncEnabled: false
                          keyterms: []
                          waitseconds: 1.2
                        voicemailConfig:
                          isEnabled: false
                        backChannelConfig:
                          isEnabled: false
                          backchannelWords: []
                        timeoutConfig:
                          silenceTimeout: 30
                          maximumDuration: 600
                        callConfig:
                          timeZone: UTC
                          maxDuration: 600
                          voicemailDetection:
                            enabled: true
                            type: ml-based
                          recordingEnabled: true
                          transcriptionEnabled: true
                          speakerBoost: false
                          idleReminders:
                            - false
                            - 0.75
                          limitCallDuration:
                            - false
                            - 20
                          backGroundNoiseThreshold: 0.75
                          backGroundNoiseTimeout: 10
                          backGroundNoiseTimeoutThreshold: 0.75
                          backGroundNoiseTimeoutInterval: 10
                        fillerWords: false
                        DND: true
                        status: true
                        customVocabulary: []
                        timezone: Asia/Kolkata
                        countryName: India
                        greeting: Hi! How can I assist you today?
                        prompt: >-
                          You are a helpful AI assistant focused on providing
                          accurate and friendly responses.
                        knowledgeBases: []
                        actions: []
                        deployment:
                          status: draft
                          version: 1
                          deployedAt: '2026-04-03T10:14:04.349000'
                          lastUpdated: '2026-04-03T10:14:04.349000'
                        stats:
                          totalCalls: 0
                          successRate: 1
                          avgCallDuration: 0
                        recommendedActions: []
                        widget: true
                        createdAt: '2026-04-03T10:14:04.349000'
                        updatedAt: '2026-04-03T10:14:04.349000'
        '400':
          description: Bad Request / Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 400
                  message:
                    type: string
                    example: agent_id is required
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 401
                  message:
                    type: string
                    example: Unauthorized access
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 403
                  message:
                    type: string
                    example: Access denied. Scope does not match
        '404':
          description: Agent not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 404
                  message:
                    type: string
                    example: agent not found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 500
                  message:
                    type: string
                    example: Something went wrong. Please try again later.
      security:
        - apiKey: []
        - bearerAuth: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````