Skip to main content
GET
/
api
/
calls
List Calls
curl --request GET \
  --url https://api.example.com/api/calls
{
  "calls": [
    {
      "call_sid": "call_xyz",
      "to_number": "+1555...",
      "from_number": "+1555...",
      "status": "completed",
      "direction": "outbound",
      "started_at": "2024-01-01T10:00:00Z",
      "ended_at": "2024-01-01T10:05:00Z",
      "duration": 300,
      "agent_name": "Sales Rep"
    }
  ],
  "count": 1,
  "organization": "My Org"
}
Retrieve a list of calls for your organization.
​
limit
integer
default:"50"
Maximum number of calls to return.

​
Response

​
calls
array
List of call objects.
​
count
number
Number of calls returned.
{
  "calls": [
    {
      "call_sid": "call_xyz",
      "to_number": "+1555...",
      "from_number": "+1555...",
      "status": "completed",
      "direction": "outbound",
      "started_at": "2024-01-01T10:00:00Z",
      "ended_at": "2024-01-01T10:05:00Z",
      "duration": 300,
      "agent_name": "Sales Rep"
    }
  ],
  "count": 1,
  "organization": "My Org"
}