Skip to main content
GET
/
v1
/
agents
List AI Agents
curl --request GET \
  --url https://api.example.com/v1/agents \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "agents": [
    {
      "agent_id": "<string>",
      "unique_id": "<string>",
      "id": "<string>",
      "agent_name": "<string>",
      "agent_type": "<string>",
      "agent_status": "<string>",
      "greeting_prompt": "<string>",
      "general_prompt": "<string>",
      "follow_up_prompt": "<string>",
      "organization_id": "<string>",
      "created_by_user_id": "<string>",
      "tenant_id": "<string>",
      "visibility": "<string>",
      "accessible_users": [
        {}
      ],
      "voice_agent_id": "<string>",
      "voice_llm_id": "<string>",
      "voice_id": "<string>",
      "voice_speed": 123,
      "voice_emotion": "<string>",
      "first_sentence": "<string>",
      "agent_accent": "<string>",
      "agent_gender": "<string>",
      "drip_schedule": [
        {
          "day": 123,
          "message": "<string>"
        }
      ],
      "drip_start_datetime": {},
      "first_message_delay": 123,
      "detect_voicemail": true,
      "voicemail_content": "<string>",
      "backchannel": true,
      "interruption_sensitivity": 123,
      "ambient_sound": "<string>",
      "instant_transfer_number": "<string>",
      "conversation_flow_id": "<string>",
      "is_chat_bot": true,
      "is_sms_agent": true,
      "is_sms_transfer_agent": true,
      "ai_agent_name": "<string>",
      "last_modification_timestamp": {},
      "created_at": {},
      "modified_at": {}
    }
  ],
  "powered_by": "<string>"
}

​
Description

Returns all AI agents (SMS and Voice) for an organization. Admins see all org agents, regular users see only their own agents.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Query Parameters

​
organization_id
string
required
Organization unique_id
​
user_id
string
User unique_id (required for non-admin users)
​
is_admin
boolean
default:"false"
If true, returns all org agents. If false, returns only user’s agents.
​
agent_type
string
Filter by agent type: sms or voice

​
Response Fields

​
success
boolean
Whether the request was successful
​
count
integer
Total number of agents
​
agents
array
Array of agent objects
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/agents?organization_id=1762896364768x389173798861431550&user_id=1762896366429x599348279945132448&is_admin=true" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 8,
  "agents": [
    {
      "agent_id": "1763487456442x530311914019296484",
      "unique_id": "1763487457756x172633473964121938",
      "id": "c43fc766-9e49-46aa-9a46-325c8c894a58",
      "agent_name": "Voice Agent 1",
      "agent_type": "voice",
      "agent_status": "active",
      "greeting_prompt": "Hi {{first_name}}, how can I help you today?",
      "general_prompt": "You are a helpful AI assistant.",
      "follow_up_prompt": null,
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "created_by_user_id": "0cf76f73-a751-4f65-b7bf-37f6cd5fdced",
      "tenant_id": "your_tenant",
      "visibility": "organization",
      "accessible_users": null,
      "voice_agent_id": "agent_76e782f267fad7f112b2339e2f",
      "voice_llm_id": "llm_76ba232bb992d5bc1ca3b83b6a00",
      "voice_id": "11labs-Adrian",
      "voice_speed": null,
      "voice_emotion": null,
      "first_sentence": null,
      "agent_accent": null,
      "agent_gender": null,
      "drip_schedule": null,
      "drip_start_datetime": null,
      "first_message_delay": null,
      "detect_voicemail": false,
      "voicemail_content": null,
      "backchannel": false,
      "interruption_sensitivity": null,
      "ambient_sound": null,
      "instant_transfer_number": null,
      "conversation_flow_id": null,
      "is_chat_bot": false,
      "is_sms_agent": false,
      "is_sms_transfer_agent": false,
      "ai_agent_name": null,
      "last_modification_timestamp": null,
      "created_at": "2025-11-18T17:37:37.867912",
      "modified_at": "2025-11-18T17:37:37.867912"
    },
    {
      "agent_id": "1762896437306x529035742905669631",
      "unique_id": "1762896437665x972848053812720437",
      "id": "c7ba209b-a464-44ce-a685-21a5508e8474",
      "agent_name": "SMS Agent",
      "agent_type": "sms",
      "agent_status": "active",
      "greeting_prompt": "Hi {{first_name}}, did you want to develop a software for your business?\n",
      "general_prompt": "You are working for Pranta Nir Software Solutions. You are supposed to ask users if they want any consulting or software development support. If yes, ask them their budget for the software. \n",
      "follow_up_prompt": null,
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "created_by_user_id": "0cf76f73-a751-4f65-b7bf-37f6cd5fdced",
      "tenant_id": "your_tenant",
      "visibility": "organization",
      "accessible_users": null,
      "drip_schedule": [],
      "drip_start_datetime": "2025-11-11T21:27:17.306285+00:00",
      "first_message_delay": null,
      "voice_agent_id": null,
      "voice_llm_id": null,
      "voice_id": null,
      "voice_speed": null,
      "voice_emotion": null,
      "first_sentence": null,
      "agent_accent": null,
      "agent_gender": null,
      "detect_voicemail": false,
      "voicemail_content": null,
      "backchannel": false,
      "interruption_sensitivity": null,
      "ambient_sound": null,
      "instant_transfer_number": null,
      "conversation_flow_id": null,
      "is_chat_bot": false,
      "is_sms_agent": false,
      "is_sms_transfer_agent": false,
      "ai_agent_name": null,
      "last_modification_timestamp": null,
      "created_at": "2025-11-11T21:27:17.734523",
      "modified_at": "2025-11-11T21:27:17.734523"
    },
    {
      "agent_id": "1763500416653x437043850941191495",
      "unique_id": "1763500417669x523666197914196602",
      "id": "74014854-b110-46c8-b037-18f0149baae6",
      "agent_name": "Emma Agent",
      "agent_type": "voice",
      "agent_status": "active",
      "greeting_prompt": "Hi {{first_name}}, did you want to develop a software for your business?\n",
      "general_prompt": "You are working for Pranta Nir Software Solutions. You are supposed to ask users if they want any consulting or software development support. If yes, ask them their budget for the software. If they give you a budget, tell them an approximate cost of the software in industry standards. Make sure to book an appointment with the team. If they miss the call, try to call them back just once more.\n",
      "follow_up_prompt": null,
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "created_by_user_id": "0cf76f73-a751-4f65-b7bf-37f6cd5fdced",
      "tenant_id": "your_tenant",
      "visibility": "organization",
      "accessible_users": null,
      "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
      "voice_llm_id": "llm_768537625c23c0da51a0c10861e0",
      "voice_id": "11labs-Adrian",
      "voice_speed": null,
      "voice_emotion": null,
      "first_sentence": null,
      "agent_accent": null,
      "agent_gender": null,
      "drip_schedule": null,
      "drip_start_datetime": null,
      "first_message_delay": null,
      "detect_voicemail": false,
      "voicemail_content": null,
      "backchannel": false,
      "interruption_sensitivity": null,
      "ambient_sound": null,
      "instant_transfer_number": null,
      "conversation_flow_id": null,
      "is_chat_bot": false,
      "is_sms_agent": false,
      "is_sms_transfer_agent": false,
      "ai_agent_name": null,
      "last_modification_timestamp": null,
      "created_at": "2025-11-18T21:13:37.738804",
      "modified_at": "2025-11-18T21:13:37.738804"
    }
  ],
  "powered_by": "Teli"
}
400 (Missing Organization ID)
{
  "error": "organization_id required",
  "success": false,
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list agents",
  "success": false,
  "powered_by": "Teli"
}

​
Filtering

​
By Agent Type

Add agent_type=voice to get only voice agents, or agent_type=sms for SMS agents only.

​
By Permission

  • Admin users (is_admin=true): See all organization agents
  • Regular users (is_admin=false): See only their own agents

​
Notes

  • Voice agents have voice_agent_id and voice_llm_id
  • SMS agents have drip_schedule for automated follow-ups
  • Both agent types support variable substitution: {{first_name}}, {{last_name}}
  • Usage metrics are tracked per agent for billing