Skip to main content
GET
/
api
/
agents
/
{agent_id}
/
conversations
List Agent Conversations
curl --request GET \
  --url https://api.getello.ai/api/agents/{agent_id}/conversations \
  --header 'X-API-Key: <api-key>'
{
  "status": 200,
  "message": "Conversations retrieved successfully",
  "data": {
    "conversations": [
      {
        "conversation_id": "6900b87ca70928b1224f0619",
        "assistant_id": "68dce5202fc07b92042493b1",
        "status": "disconnected",
        "outcome": "positive",
        "call_duration": "00:23:52",
        "call_connected_at": "2025-10-28T12:35:17.423000",
        "call_disconnected_at": "2025-10-28T12:59:09.821000"
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 20,
    "pages": 3
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "totalPages": 3,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

agent_id
string
required

Unique identifier of the agent.

Example:

"234d3e"

Query Parameters

page
integer
default:1

Page number for pagination.

Required range: x >= 1
limit
integer
default:20

Number of conversations per page.

Required range: 1 <= x <= 100
fromDate
string<date-time>

Start date to filter conversations.

Example:

"2025-10-01T00:00:00Z"

toDate
string<date-time>

End date to filter conversations.

Example:

"2025-10-28T23:59:59Z"

Response

Conversations retrieved successfully

status
integer
Example:

200

message
string
Example:

"Conversations retrieved successfully"

data
object
pagination
object