Skip to main content
POST
Get call information
Returns call details and analysis for the supplied call and agent IDs. The API key must belong to the supplied user, and that user must have access to the agent. Phonely returns 404 when the call does not exist or does not belong to the specified agent.

Authorizations

X-Authorization
string
header
required

Body

application/json
uid
string
required

User ID (can be retrieved from the user settings page)

agentId
string
required

Agent ID (can be retrieved from the agent settings page)

callId
string
required

Call ID (can be retrieved from the call history page)

Response

Successful response

agentName
string
required

Name of the agent handling the call

transcriptText
string
required

Text transcript containing user and assistant messages

dashboardUrl
string<uri>
required

URL to open the call in Phonely

callId
string

Unique identifier for the call

agentId
string

ID of the agent that handled the call

businessPhoneNumber
string | null

Business phone number used for the call

customerPhoneNumber
string | null

Customer phone number

transcript
object[] | null

Structured call messages

messages
object[] | null

Structured call messages; currently the same data as transcript

summary
string | null

Brief summary of the call

longSummary
string | null

Detailed summary of the call

ai_success
boolean | null

Whether the AI completed the call successfully

sentiment
string | null

Overall sentiment of the call

topic

Topic or topic labels assigned to the call

purpose
string | null

Main purpose of the call

keyPoints
string[] | null

Key points identified during the call

mentionedDate
string | null

Date mentioned during the call

mentionedTime
string | null

Time mentioned during the call

mentionedEmail
string | null

Email address mentioned during the call

callerName
string | null

Caller name extracted from the call

unansweredQuestions
string[] | null

List of questions that were not answered during the call

actionItems
string[] | null

List of action items identified during the call

followUpReason
string | null

Reason for any required follow-up

followUp
boolean | null

Whether follow-up is required

callDirection
string | null

Call type or direction

recordingUrl
string | null

URL to access the call recording

callStarted
object

Serialized Firestore timestamp

startedAt
object

Serialized Firestore timestamp

callEnded
object

Serialized Firestore timestamp

callStartedDateString
string

Call start formatted in the agent's timezone

callEndedDateString
string

Call end formatted in the agent's timezone

duration
number

Duration of the call in seconds

endedReason
string | null

Reason for the call ending

Last modified on August 10, 2026