Get Agent | Levrage.AI | API Documentation

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Sales Agent",
    "language": "English",
    "agent_type": "sales",
    "description": "Qualifies leads for personal loan products",
    "sector": "Finance & Banking",
    "tone": "professional",
    "agent_role": "Sales Agent",
    "ai_model": "lai-premium-2",
    "voice": "female",
    "pronunciations": {
      "Levrage": "Lev-rahj"
    },
    "voice_response_settings": {
      "listening_sensitivity": 0.5,
      "wait_before_responding": 200,
      "silence_to_end_turn": 300,
      "allow_user_to_interrupt": true,
      "words_to_interrupt": 2,
      "min_response_wait": 0.15,
      "max_response_wait": 0.3,
      "fast_response": true,
      "voice_detection_sensitivity": 0.5,
      "quick_response_padding": 200,
      "turn_end_silence": 300,
      "vad_type": "server_vad",
      "eagerness": "medium",
      "remind_on_silence": true,
      "silence_before_reminder": 10,
      "max_reminders": 3,
      "detect_ivr_systems": true,
      "enable_dtmf_input": false,
      "leave_voicemail": false,
      "max_call_duration_minutes": 15,
      "greeting_delay": 0,
      "call_analysis_enabled": true,
      "immediate_transfer": false,
      "response_creativity": 0.8,
      "turn_detection": "vad"
    },
    "prompt": "You are an AI sales agent for Acme Finance. Qualify leads for personal loans.",
    "start_flow": "Hello! I'm calling from Acme Finance. Am I speaking with the right person?",
    "end_flow": "Thank you for your time! Have a great day.",
    "details_to_collect": [
      {
        "key": "full_name",
        "type": "text",
        "description": "Customer's full name"
      },
      {
        "key": "monthly_income",
        "type": "number",
        "description": "Customer's monthly income"
      }
    ],
    "brand_name": "Acme Finance",
    "typed_knowledge": "Personal loan products from 50,000 to 25,00,000 INR. Interest rates starting at 10.5% p.a.",
    "timezone": "Asia/Kolkata",
    "other_languages": [
      "Hindi"
    ],
    "webhook_config": {
      "url": "https://api.yourcompany.com/webhooks/levrage",
      "events": [
        "call.completed",
        "call.failed"
      ]
    },
    "custom_api": [],
    "lookup_api": {
      "enabled": true,
      "api_name": "Customer CRM Lookup",
      "api_url": "https://api.yourcompany.com/customers",
      "method": "GET",
      "query_params": [
        {
          "key": "phone",
          "value": "{number}",
          "is_variable": true
        }
      ],
      "headers": [
        {
          "key": "Authorization",
          "value": "Bearer your_crm_api_key",
          "is_variable": false
        }
      ],
      "timeout_seconds": 10,
      "retry_count": 1
    },
    "transfer_map": [
      {
        "name": "Sales Manager",
        "number": "9876543210",
        "country_code": "+91",
        "category": "escalation"
      }
    ],
    "is_active": true,
    "created_at": "2026-01-15T09:30:00+05:30",
    "updated_at": "2026-01-15T09:30:00+05:30"
  },
  "request_id": "req_a1b2c3d4e5f6",
  "timestamp": "2026-01-15T09:30:00+05:30",
  "success": true
}

Get full details of a specific agent by ID.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

agent_idstringRequired

Response

Successful Response

dataobject

Full agent detail response.

request_idstring

timestampdatetime

successbooleanOptionalDefaults to true

Errors

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://api.levrage.ai/v1/agents/agent_id"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())