Skip to main content
GET
/
api
/
v1
/
calling
/
call-sessions
List Call Sessions
curl --request GET \
  --url https://api.ravan.ai/api/v1/calling/call-sessions \
  --header 'X-Api-Key: <api-key>'
{
  "success": true,
  "message": "<string>",
  "data": [
    {
      "id": "<string>",
      "agent_id": "<string>",
      "agent_name": "<string>",
      "organization_id": "<string>",
      "room_id": "<string>",
      "caller_number": "<string>",
      "callee_number": "<string>",
      "channel": "<string>",
      "status": "<string>",
      "summary": "<string>",
      "metadata": {},
      "disconnect_reason": "<string>",
      "call_latency_ms": 123,
      "duration_sec": 123,
      "recording_url": "<string>",
      "cost_total": 123,
      "started_at": "<string>",
      "ended_at": "<string>"
    }
  ],
  "meta": {
    "total": 123,
    "limit": 123,
    "offset": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ravan.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-Api-Key
string
required
Your Agni API key. Find it in your RavanAi.

Query Parameters

page
integer
Page number (default 1)
page_size
integer
Results per page (default 20)
agent_id
string
Filter by agent ID
status
string
Filter by status
channel
string
Filter by channel
caller_number
string
Filter by caller number
Search term
sort_by
string
Sort field
sort_order
string
Sort order (asc/desc)
started_after
string
Filter sessions started after (ISO 8601)
started_before
string
Filter sessions started before (ISO 8601)

Response

success
boolean
Whether the request succeeded.
message
string
Human-readable status message.
data
array
Array of call session objects.
meta
object
Pagination metadata.

Authorizations

X-Api-Key
string
header
required

Query Parameters

page
integer
default:1

Page number

page_size
integer
default:20

Results per page

agent_id
string

Filter by agent ID

status
string

Filter by status

channel
string

Filter by channel

caller_number
string

Filter by caller number

Search term

sort_by
string

Sort field

sort_order
string

Sort order (asc/desc)

started_after
string

Filter after (ISO 8601)

started_before
string

Filter before (ISO 8601)

Response

200 - application/json

Successful response

success
boolean
message
string
data
object[]
meta
object