List calls

List all calls for the authenticated user with filtering options

GET /user/calls

List calls

cURL

curl --request GET \
  --url https://app.voicery.ai/api/user/calls \
  --header 'Authorization: Bearer <token>'

200 Response

{
  "current_page": 1,
  "data": [
    {
      "id": 123,
      "assistant_name": "Sales Assistant",
      "campaign_name": "Q4 Outreach Campaign",
      "type": "outbound",
      "duration": 245,
      "assistant_phone_number": "[phone]",
      "client_phone_number": "[phone]",
      "status": "completed",
      "transcript": "Hello, this is Sarah from Voicery. 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.voicery.ai/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://app.voicery.ai/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://app.voicery.ai/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.voicery.ai/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.voicery.ai/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.voicery.ai/api/user/calls?page=2",
  "path": "https://app.voicery.ai/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

Show properties

id · integer

The unique identifier of the call

assistant_name · string

The name of the assistant that handled the call

campaign_name · string

The name of the campaign this call belongs to (if applicable)

type · string

The type of the call (inbound, outbound, or web)

duration · integer

The duration of the call in seconds

assistant_phone_number · string

The phone number used by the assistant

client_phone_number · string

The phone number of the client

status · string

The current status of the call

transcript · string

The transcript of the call conversation

variables · object

Variables collected during the call

evaluation · object

Evaluation data for the call performance

webhook_response · object

Response from any configured webhooks

carrier_cost · number

The cost charged by the carrier for this call

total_cost · number

The total cost of the call including all fees

answered_by · string

Who answered the call (human, machine, or unknown)

recording_url · string

URL to the call recording (if available and enabled)

created_at · string

The date and time when the call was created

updated_at · string

The date and time when the call was last updated

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

200 Response

{
  "current_page": 1,
  "data": [
    {
      "id": 123,
      "assistant_name": "Sales Assistant",
      "campaign_name": "Q4 Outreach Campaign",
      "type": "outbound",
      "duration": 245,
      "assistant_phone_number": "[phone]",
      "client_phone_number": "[phone]",
      "status": "completed",
      "transcript": "Hello, this is Sarah from Voicery. 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.voicery.ai/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://app.voicery.ai/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://app.voicery.ai/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.voicery.ai/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.voicery.ai/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.voicery.ai/api/user/calls?page=2",
  "path": "https://app.voicery.ai/api/user/calls",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}