Skip to main content
POST
/
v1
/
list-calls
curl -X POST https://api.voicy.co/v1/list-calls \
  -H "Authorization: Bearer voicy_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_criteria": {
      "call_status": ["ended"]
    },
    "sort_order": "descending",
    "limit": 10
  }'

[
  {
    "call_id": "550e8400-e29b-41d4-a716-446655440000",
    "call_type": "phone_call",
    "call_status": "ended",
    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
    "from_number": "+15551234567",
    "to_number": "+15559876543",
    "direction": "outbound",
    "start_timestamp": 1704067200000,
    "end_timestamp": 1704067320000,
    "duration_ms": 120000
  },
  {
    "call_id": "550e8400-e29b-41d4-a716-446655440002",
    "call_type": "phone_call",
    "call_status": "ended",
    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
    "from_number": "+15559876543",
    "to_number": "+15551234567",
    "direction": "inbound",
    "start_timestamp": 1704063600000,
    "end_timestamp": 1704063780000,
    "duration_ms": 180000
  }
]
Retrieve a list of calls with optional filtering by status, agent, direction, and time range.
This endpoint uses POST to support complex filter criteria in the request body.

​
Request Body

​
filter_criteria
object
Optional filters to apply.
​
sort_order
string
default:"descending"
Sort order: ascending or descending (by start time).
​
limit
integer
default:"50"
Maximum number of results (1-1000).
​
pagination_key
string
Cursor for pagination. Use the last call_id from the previous page.

​
Response

Returns an array of call summary objects.
​
call_id
string
Unique identifier for the call.
​
call_type
string
Type of call (phone_call).
​
call_status
string
Current status of the call.
​
agent_id
string
ID of the agent handling the call.
​
from_number
string
The caller’s phone number.
​
to_number
string
The called phone number.
​
direction
string
Call direction.
​
start_timestamp
integer
Unix timestamp (ms) when call started.
​
end_timestamp
integer
Unix timestamp (ms) when call ended.
​
duration_ms
integer
Call duration in milliseconds.
curl -X POST https://api.voicy.co/v1/list-calls \
  -H "Authorization: Bearer voicy_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_criteria": {
      "call_status": ["ended"]
    },
    "sort_order": "descending",
    "limit": 10
  }'

[
  {
    "call_id": "550e8400-e29b-41d4-a716-446655440000",
    "call_type": "phone_call",
    "call_status": "ended",
    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
    "from_number": "+15551234567",
    "to_number": "+15559876543",
    "direction": "outbound",
    "start_timestamp": 1704067200000,
    "end_timestamp": 1704067320000,
    "duration_ms": 120000
  },
  {
    "call_id": "550e8400-e29b-41d4-a716-446655440002",
    "call_type": "phone_call",
    "call_status": "ended",
    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
    "from_number": "+15559876543",
    "to_number": "+15551234567",
    "direction": "inbound",
    "start_timestamp": 1704063600000,
    "end_timestamp": 1704063780000,
    "duration_ms": 180000
  }
]