List Agents

Retrieve all agents for the authenticated team.

HTTP Request

$GET https://app.resemble.ai/api/v2/agents

Query Parameters

ParameterTypeDescription
phone_numberstringFilter agents by associated phone number (optional)
advancedbooleanInclude detailed agent configuration (default: false)

Example Request

$curl --request GET "https://app.resemble.ai/api/v2/agents" \
> -H "Authorization: Bearer YOUR_API_TOKEN" \
> -H "Content-Type: application/json"

Example Request with Query Parameters

$curl --request GET "https://app.resemble.ai/api/v2/agents?advanced=true&phone_number=%2B14155551234" \
> -H "Authorization: Bearer YOUR_API_TOKEN" \
> -H "Content-Type: application/json"

Response

1{
2 "success": true,
3 "items": [
4 {
5 "agent": {
6 "name": "Customer Support Agent",
7 "uuid": "550e8400-e29b-41d4-a716-446655440000",
8 "languages": ["en-US"],
9 "dynamic_variables": {
10 "customer_name": "John Doe",
11 "account_id": "12345"
12 },
13 "created_at": "2025-01-15T10:30:00Z",
14 "updated_at": "2025-01-20T14:45:00Z",
15 "last_active_at": "2025-01-27T09:00:00Z",
16 "calls_today": 15,
17 "status": "active"
18 },
19 "asr": {
20 "provider": "deepgram",
21 "model": "nova-2",
22 "user_input_audio_format": "pcm_16000",
23 "keywords": ["resemble", "account", "billing"]
24 },
25 "tts": {
26 "voice_uuid": "abc123",
27 "voice_name": "Professional Voice"
28 },
29 "turn": {
30 "turn_timeout": 7,
31 "silence_end_call_timeout": -1,
32 "mode": "silence"
33 },
34 "llm": {
35 "prompt": "You are a helpful customer support agent.",
36 "provider": "openai",
37 "model": "gpt-4o",
38 "reasoning_effort": null,
39 "temperature": 0.3,
40 "timezone": "America/New_York",
41 "built_in_tools": {}
42 },
43 "phone_numbers": [
44 {
45 "id": 1,
46 "phone_number": "+14155551234",
47 "label": "Support Line",
48 "supports_inbound": true,
49 "supports_outbound": false,
50 "provider": "twilio",
51 "outbound_trunk": {},
52 "inbound_trunk": {},
53 "created_at": "2025-01-15T10:30:00Z",
54 "updated_at": "2025-01-15T10:30:00Z"
55 }
56 ],
57 "tools_count": 3,
58 "webhooks_count": 2
59 }
60 ],
61 "count": 1
62}

Response Body (Basic Mode - advanced=false)

AttributeTypeDescription
successbooleanIndicates if the request was successful
itemsarrayArray of agent objects
countintegerTotal number of agents
agent.namestringName of the agent
agent.uuidstringUnique identifier for the agent
agent.languagesarraySupported language codes (currently only “en-US”)
agent.dynamic_variablesobjectKey-value pairs for runtime variable substitution
agent.created_atstringISO8601 timestamp of creation
agent.updated_atstringISO8601 timestamp of last update
agent.last_active_atstringISO8601 timestamp of last activity (null if never active)
agent.calls_todayintegerNumber of calls today
agent.statusstringAgent status: “active” or “inactive”
tools_countintegerNumber of tools configured
webhooks_countintegerNumber of webhooks configured

Response Body (Advanced Mode - advanced=true)

In advanced mode, tools_count and webhooks_count are replaced with:

AttributeTypeDescription
toolsarrayFull array of tool objects with configurations
knowledge_basesarrayArray of knowledge base configurations
webhooksarrayFull array of webhook objects with configurations