Skip to main content
POST
/
list-calls
curl -X POST https://api.magpipe.ai/functions/v1/list-calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 20,
    "direction": "outbound",
    "from_date": "2024-01-01T00:00:00Z"
  }'

{
  "calls": [
    {
      "id": "7f3d8e00-a1b2-4c3d-9e4f-567890abcdef",
      "agent_id": "550e8400-e29b-41d4-a716-446655440000",
      "from_number": "+16045551234",
      "to_number": "+14155551234",
      "direction": "outbound",
      "status": "completed",
      "duration": 125,
      "sentiment": "positive",
      "call_summary": "Appointment confirmed for tomorrow at 2pm.",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 156,
  "has_more": true
}
Retrieve a paginated list of calls for your account. Supports filtering by date range, status, direction, and agent.

​
Request Body

​
limit
integer
default:50
Maximum number of calls to return. Max: 100.
​
offset
integer
default:0
Number of calls to skip for pagination.
​
direction
string
Filter by call direction: inbound or outbound.
​
status
string
Filter by call status: completed, busy, no-answer, failed, canceled.
​
agent_id
string
Filter by specific agent UUID.
​
from_date
string
Filter calls after this ISO 8601 date.
​
to_date
string
Filter calls before this ISO 8601 date.
​
phone_number
string
Filter by phone number (either from or to).

​
Response

​
calls
array
Array of call objects.
​
total
integer
Total number of calls matching the filters.
​
has_more
boolean
Whether there are more calls to paginate through.
curl -X POST https://api.magpipe.ai/functions/v1/list-calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 20,
    "direction": "outbound",
    "from_date": "2024-01-01T00:00:00Z"
  }'

{
  "calls": [
    {
      "id": "7f3d8e00-a1b2-4c3d-9e4f-567890abcdef",
      "agent_id": "550e8400-e29b-41d4-a716-446655440000",
      "from_number": "+16045551234",
      "to_number": "+14155551234",
      "direction": "outbound",
      "status": "completed",
      "duration": 125,
      "sentiment": "positive",
      "call_summary": "Appointment confirmed for tomorrow at 2pm.",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 156,
  "has_more": true
}