Logo
Platform Guide
API Reference
Platform Updates
Platform updates
Calls

List calls

List all calls for the authenticated user with filtering options

GET

/ user / calls

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

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

List calls
200 Response
{
  "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 OtoniStark. 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://call.otonistark.com.br/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://call.otonistark.com.br/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://call.otonistark.com.br/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://call.otonistark.com.br/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://call.otonistark.com.br/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://call.otonistark.com.br/api/user/calls?page=2",
  "path": "https://call.otonistark.com.br/api/user/calls",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}