Skip to main content
GET
/
user
/
calls
List calls
curl --request GET \
  --url https://platform.spotzyai.com/api/user/calls \
  --header 'Authorization: Bearer <token>'
{
  "current_page": 1,
  "data": [
    {
      "id": 123,
      "assistant_name": "Sales Assistant",
      "campaign_name": "Q4 Outreach Campaign",
      "type": "outbound",
      "duration": 245,
      "assistant_phone_number": "+1234567890",
      "client_phone_number": "+1987654321",
      "status": "completed",
      "transcript": "Hello, this is Sarah from SpotzyAI. How are you doing today?...",
      "variables": {
        "customer_name": "John Smith",
        "interest_level": "high",
        "follow_up_date": "2025-08-15"
      },
      "evaluation": {
        "sentiment": "positive",
        "outcome": "qualified_lead",
        "score": 8.5
      },
      "webhook_response": {
        "status": "success",
        "data": {
          "crm_contact_id": "abc123"
        }
      },
      "carrier_cost": 0.02,
      "total_cost": 0.025,
      "answered_by": "human",
      "recording_url": "https://recordings.spotzyai.com/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://platform.spotzyai.com/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://platform.spotzyai.com/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://platform.spotzyai.com/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://platform.spotzyai.com/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://platform.spotzyai.com/api/user/calls?page=2",
  "path": "https://platform.spotzyai.com/api/user/calls",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}
This endpoint allows you to list all calls belonging to the authenticated user with various filtering options.

​
Query Parameters

​
status
string
Filter calls by status. Possible values: initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, no-answer, failed
​
type
string
Filter calls by type. Possible values: inbound, outbound, web
​
phone_number
string
Filter calls by client phone number
​
assistant_id
integer
Filter calls by assistant ID
​
campaign_id
integer
Filter calls by campaign ID
​
date_from
string
Filter calls from this date (YYYY-MM-DD format)
​
date_to
string
Filter calls until this date (YYYY-MM-DD format)
​
per_page
integer
Number of calls per page (1-100, default: 15)
​
page
integer
Page number (default: 1)

​
Response fields

​
data
array
​
current_page
integer
The current page number
​
per_page
integer
Number of items per page
​
total
integer
Total number of calls matching the criteria
​
last_page
integer
The last page number
{
  "current_page": 1,
  "data": [
    {
      "id": 123,
      "assistant_name": "Sales Assistant",
      "campaign_name": "Q4 Outreach Campaign",
      "type": "outbound",
      "duration": 245,
      "assistant_phone_number": "+1234567890",
      "client_phone_number": "+1987654321",
      "status": "completed",
      "transcript": "Hello, this is Sarah from SpotzyAI. How are you doing today?...",
      "variables": {
        "customer_name": "John Smith",
        "interest_level": "high",
        "follow_up_date": "2025-08-15"
      },
      "evaluation": {
        "sentiment": "positive",
        "outcome": "qualified_lead",
        "score": 8.5
      },
      "webhook_response": {
        "status": "success",
        "data": {
          "crm_contact_id": "abc123"
        }
      },
      "carrier_cost": 0.02,
      "total_cost": 0.025,
      "answered_by": "human",
      "recording_url": "https://recordings.spotzyai.com/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://platform.spotzyai.com/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://platform.spotzyai.com/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://platform.spotzyai.com/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://platform.spotzyai.com/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://platform.spotzyai.com/api/user/calls?page=2",
  "path": "https://platform.spotzyai.com/api/user/calls",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}