List Calls

GET

calls

{agentId}

List calls by agent ID

curl --request GET \
  --url https://app.phonely.ai/api/calls/{agentId} \
  --header 'X-Authorization: <api-key>'

const options = {method: 'GET', headers: {'X-Authorization': '<api-key>'}};

fetch('https://app.phonely.ai/api/calls/{agentId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.phonely.ai/api/calls/{agentId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.phonely.ai/api/calls/{agentId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.phonely.ai/api/calls/{agentId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": "<string>",
      "agentId": "<string>",
      "c_topic": "<string>",
      "business_phone_number": "<string>",
      "customer_phone_number": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z",
      "duration": 123,
      "status": "QUEUED",
      "recording_url": "<string>",
      "ended_reason": "<string>",
      "type": "inboundPhoneCall",
      "mode": "call",
      "read": true,
      "c_sentiment": "Positive",
      "c_outcome": "<string>",
      "ab_test_type": "<string>",
      "ab_test_id": "<string>",
      "ab_test_success": true,
      "draft_agent_version": "<string>",
      "draft_agent_id": "<string>",
      "workflow_path_history": [
        {
          "actionId": "<string>",
          "workflowId": "<string>",
          "readableName": "<string>"
        }
      ],
      "campaign_id": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Returns a paginated list of calls for an agent. Authentication must grant access to the agent in the path. Repeat array query parameters such as status, sentiment, call_type, outcome, ended_reason, and mode to include multiple values. Dates use ISO 8601 date-time values, and durations are measured in seconds. Use campaign_id or ab_test_id to restrict results to a campaign or A/B test. The response’s total is the number of matching calls before limit and offset are applied.

Authorizations

X-Authorization

string

header

required

Path Parameters

agentId

string

required

The ID of the agent whose calls you want to retrieve

Query Parameters

limit

integer

default:100

Maximum number of results to return

offset

integer

default:0

Number of results to skip for pagination

customer_phone_number

string

Filter by customer phone number

campaign_id

string

Filter by campaign ID

ab_test_id

string

Filter by A/B test ID

status

enum<string>[]

Filter by call status (can specify multiple values)

Available options:

QUEUED,

IN_PROGRESS,

ENDED,

COMPLETED,

FAILED,

DNC,

REDIAL_SCHEDULED,

QUEUEING,

IN_WARM_TRANSFER

sentiment

enum<string>[]

Filter by sentiment (can specify multiple values)

Available options:

Positive,

Negative,

Neutral,

Unsure

call_type

enum<string>[]

Filter by call type (can specify multiple values)

Available options:

inboundPhoneCall,

outboundPhoneCall,

dailyCall,

webCall,

messagingSession,

callAndMessaging

outcome

string[]

Filter by call outcome (can specify multiple values)

ended_reason

string[]

Filter by call ended reason (can specify multiple values)

mode

string[]

Filter by call mode (can specify multiple values)

start_date

string<date-time>

Filter calls after this date (ISO 8601 datetime format)

end_date

string<date-time>

Filter calls before this date (ISO 8601 datetime format)

min_duration

number

Minimum call duration in seconds

max_duration

number

Maximum call duration in seconds

Response

Successful response

items

object[]

required

Array of call objects matching the filter criteria

Show child attributes

total

integer

required

Total number of calls matching the filters (not limited by pagination)

limit

integer

required

The limit value used in the request

offset

integer

required

The offset value used in the request

Last modified on August 10, 2026

⌘I

List calls by agent ID

curl --request GET \
  --url https://app.phonely.ai/api/calls/{agentId} \
  --header 'X-Authorization: <api-key>'

const options = {method: 'GET', headers: {'X-Authorization': '<api-key>'}};

fetch('https://app.phonely.ai/api/calls/{agentId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.phonely.ai/api/calls/{agentId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.phonely.ai/api/calls/{agentId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.phonely.ai/api/calls/{agentId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": "<string>",
      "agentId": "<string>",
      "c_topic": "<string>",
      "business_phone_number": "<string>",
      "customer_phone_number": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z",
      "duration": 123,
      "status": "QUEUED",
      "recording_url": "<string>",
      "ended_reason": "<string>",
      "type": "inboundPhoneCall",
      "mode": "call",
      "read": true,
      "c_sentiment": "Positive",
      "c_outcome": "<string>",
      "ab_test_type": "<string>",
      "ab_test_id": "<string>",
      "ab_test_success": true,
      "draft_agent_version": "<string>",
      "draft_agent_id": "<string>",
      "workflow_path_history": [
        {
          "actionId": "<string>",
          "workflowId": "<string>",
          "readableName": "<string>"
        }
      ],
      "campaign_id": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Agent Generation

Agent Management

Call Management

Knowledge Base

Voice & Phone

Organizations

Authorizations

Path Parameters

Query Parameters

Response