Get a call

One call with its call analysis. The transcript and recording have their own endpoints.

Shared fields mean exactly what they mean in the list. A call is readable as soon as it’s queued, in any status the list’s status filter accepts, including those the list leaves out by default such as queued and failed. A call in any other status, or of another organization’s or a deleted agent, answers 404, the same as an ID that doesn’t exist. Reading a call doesn’t mark it read in the web app.

GET

calls

{id}

Get a call

curl --request GET \
  --url https://api.us.phonely.ai/v1/calls/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.us.phonely.ai/v1/calls/{id}', 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://api.us.phonely.ai/v1/calls/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.us.phonely.ai/v1/calls/{id}"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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://api.us.phonely.ai/v1/calls/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "action_items": [
    "<string>"
  ],
  "agent_id": "<string>",
  "business_phone_number": "<string>",
  "campaign_id": "<string>",
  "custom_metadata": {},
  "custom_outcome": "<string>",
  "custom_outcome_value": 123,
  "customer_name": "<string>",
  "customer_phone_number": "<string>",
  "duration_seconds": 123,
  "ended_at": "2023-11-07T05:31:56Z",
  "ended_reason": "<string>",
  "follow_up_reason": "<string>",
  "id": "<string>",
  "is_follow_up_needed": true,
  "key_points": [
    "<string>"
  ],
  "long_summary": "<string>",
  "mentioned_date": "2023-12-25",
  "mentioned_email": "<string>",
  "mentioned_time": "<string>",
  "object": "call",
  "outcome": "<string>",
  "purpose": "<string>",
  "sentiment": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "status": "<string>",
  "summary": "<string>",
  "type": "<string>",
  "unanswered_questions": [
    "<string>"
  ],
  "warm_transfer_started_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An org API key: Authorization: Bearer phk_…

Headers

Phonely-Organization

string | null

Optional. Must be the key's org.

Path Parameters

string

required

The call's ID.

Response

Successful Response

One call with its call analysis. The transcript and recording have their own endpoints.

action_items

string[] | null

required

Action items the conversation left for the customer.

agent_id

string

required

The agent that handled the call.

business_phone_number

string | null

required

The Phonely number on the call, as recorded: usually E.164, such as +14155550100.

campaign_id

string | null

required

The outbound campaign that placed the call, if any.

custom_metadata

Custom Metadata · object | null

required

Data your integration attached to the call, as sent. null when none.

custom_outcome

string | null

required

The post-call outcome your integration set, such as Booked. null when none.

custom_outcome_value

number | null

required

A number your integration set with the outcome, such as a deal value. null when none.

customer_name

string | null

required

The name the customer gave. null when they gave none.

customer_phone_number

string | null

required

The customer on the call, as recorded: usually E.164, but Anonymous or a SIP address when they withheld their number. null for web calls.

duration_seconds

number | null

required

How long the call lasted. null when not recorded, as for a call that never connected.

ended_at

string<date-time> | null

required

When the call ended. null while it is still in progress.

ended_reason

string | null

required

Why the call ended. null when it was not recorded. Known values: assistant_ended_call, assistant_forwarded_call, customer_ended_call, hangup_during_warm_transfer, max_duration_reached, silence_timeout, no_answer, user_busy, call_failed, voicemail, no_one_engaged, pre_screen_hangup, greeting_hangup, pre_greeting_hangup, greeting_timeout, pre_call_rejected, pipeline_error, unknown_error, unsure. More can be added, so handle values you don't recognize.

follow_up_reason

string | null

required

Why a person should follow up, and who.

string

required

The call's ID.

is_follow_up_needed

boolean | null

required

Whether a person should follow up with the customer.

key_points

string[] | null

required

Key points from the conversation.

long_summary

string | null

required

A longer summary from call analysis, up to six sentences.

mentioned_date

string<date> | null

required

A date mentioned on the call, such as an appointment.

mentioned_email

string | null

required

An email address mentioned on the call.

mentioned_time

string | null

required

A time mentioned on the call, as HH:mm (24-hour).

object

string

default:call

required

The type of this object, always call.

Allowed value: "call"

outcome

string | null

required

The call's outcome, as the agent's call analysis labels it.

purpose

string | null

required

The call's purpose, in a few words.

sentiment

string | null

required

The customer's sentiment: from call analysis, unless someone changed it in the web app. Known values: positive, negative, neutral, unsure. More can be added, so handle values you don't recognize.

started_at

string<date-time> | null

required

When the call started, or was queued if it never connected.

status

string

required

Where the call is in its lifecycle. Known values: completed, ended, in_progress, in_warm_transfer, queued, queueing, redial_scheduled, cancelled, dnc, failed, transferred_sold, transferred_not_sold, transferred_pending_sale, rev_share_pending_qualification, transferred_busy, transferred_no_answer, transferred_failed. More can be added, so handle values you don't recognize.

summary

string | null

required

A short summary from call analysis.

type

string | null

required

How the call happened. Known values: inbound_phone_call, outbound_phone_call, warm_transfer, web_call, web_chat, messaging_session, call_and_messaging, pay_per_call, unknown. More can be added, so handle values you don't recognize.

unanswered_questions

string[] | null

required

Questions the agent didn't answer.

warm_transfer_started_at

string<date-time> | null

required

When a warm transfer to a person began. null when there was none.

⌘I

Get a call

curl --request GET \
  --url https://api.us.phonely.ai/v1/calls/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.us.phonely.ai/v1/calls/{id}', 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://api.us.phonely.ai/v1/calls/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.us.phonely.ai/v1/calls/{id}"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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://api.us.phonely.ai/v1/calls/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "action_items": [
    "<string>"
  ],
  "agent_id": "<string>",
  "business_phone_number": "<string>",
  "campaign_id": "<string>",
  "custom_metadata": {},
  "custom_outcome": "<string>",
  "custom_outcome_value": 123,
  "customer_name": "<string>",
  "customer_phone_number": "<string>",
  "duration_seconds": 123,
  "ended_at": "2023-11-07T05:31:56Z",
  "ended_reason": "<string>",
  "follow_up_reason": "<string>",
  "id": "<string>",
  "is_follow_up_needed": true,
  "key_points": [
    "<string>"
  ],
  "long_summary": "<string>",
  "mentioned_date": "2023-12-25",
  "mentioned_email": "<string>",
  "mentioned_time": "<string>",
  "object": "call",
  "outcome": "<string>",
  "purpose": "<string>",
  "sentiment": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "status": "<string>",
  "summary": "<string>",
  "type": "<string>",
  "unanswered_questions": [
    "<string>"
  ],
  "warm_transfer_started_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": [
      {
        "field": "<string>",
        "issue": "<string>",
        "message": "<string>"
      }
    ],
    "message": "<string>",
    "request_id": "<string>"
  }
}

API v1

API v1 endpoints

Legacy API

Web SDK

Get a call

Authorizations

Headers

Path Parameters

Response