Skip to main content
GET
/
agents
List agents
curl --request GET \
  --url https://api.kallabot.com/agents \
  --header 'Authorization: Bearer <token>'
{
  "agents": [
    {
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Alfred",
      "agent_type": "other",
      "call_direction": "inbound",
      "inbound_phone_number": "+14155551234",
      "agent_image": "https://cdn.example.com/agents/alfred.png",
      "webhook_url": "https://webhooks.example.com/agents/alfred",
      "is_compliant": false,
      "total_calls": 123,
      "total_duration": 45678,
      "total_cost": 12.34,
      "created_at": "2025-08-23T12:34:56Z",
      "timezone": "America/Los_Angeles",
      "country": "US",
      "agent_config": {
        "agent_name": "Alfred",
        "call_direction": "inbound",
        "tasks": []
      },
      "agent_prompts": {
        "task_1": {
          "system_prompt": "Hello"
        }
      }
    }
  ],
  "page": 1,
  "per_page": 25,
  "total": 1
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
page
integer
default:1
​
per_page
integer
default:25

Response

200 - application/json

List of agents

Paginated list of agents belonging to the account.

​
agents
Agent List Item · object[]
required
​
page
integer

Current page (1-indexed).

​
per_page
integer

Number of items per page.

​
total
integer

Total number of agents available.