Get Call

cURL

curl --request GET \
  --url https://api.puretalk.ai/api/calls/{call_id} \
  --header 'X-API-KEY: <api-key>'

{
  "msg": "Success",
  "err": false,
  "results": {
    "call_analysis": {
      "summary": "This is a summary of the call",
      "call_completion_summary": "This is a summary of the call completion",
      "call_completion": "This is a summary of the call completion",
      "task_completion_summary": "This is a summary of the task completion",
      "task_completion": "This is a summary of the task completion",
      "post_analysis_data": [
        {
          "name": "This is the name of the post analysis data",
          "value": "This is the value of the post analysis data"
        }
      ]
    },
    "protocol": "web",
    "call_id": "be8b84ed-16d8-459e-b71c-b0f54fce5ec1",
    "from_number": "+1234567890",
    "to_number": "+1234567890",
    "assistant_id": "217b769d-befe-47a2-83bc-b014c2e19ea5",
    "assistant_name": "Appointment Setter",
    "voice_id": "Puretalktts-e0c5f2f95332",
    "voice_name": "Gabrielle",
    "start_time": "2025-05-19T10:15:22.230876-04:00",
    "end_time": "2025-05-19T10:15:22.230876-04:00",
    "call_duration_seconds": 123,
    "call_type": "outgoing",
    "transcript": "This is the transcript of the call",
    "transcript_object": [
      {
        "role": "user",
        "content": "This is the content of the transcript",
        "function_name": "get_weather",
        "interrupted": false,
        "function_args": "{\"location\": \"New York\"}",
        "tool_calls": [],
        "turn_latency": {
          "latency": 1.5,
          "eou_delay": 0.2,
          "llm_latency": 0.8,
          "tts_latency": 0.5
        }
      }
    ],
    "status": "completed",
    "provider_call_id": "CA96878fe2501423e1f018a7ab6db5498b",
    "metadata": "This is the metadata of the call",
    "variables": [
      "<string>"
    ],
    "answered_by": "human",
    "call_recording_enabled": true,
    "call_recording_url": "https://api.puretalk.ai/api/calls/1234567890/recording",
    "campaign_id": "<string>",
    "sentiment": "positive",
    "is_billed": true
  }
}

GET

calls

{call_id}

cURL

curl --request GET \
  --url https://api.puretalk.ai/api/calls/{call_id} \
  --header 'X-API-KEY: <api-key>'

{
  "msg": "Success",
  "err": false,
  "results": {
    "call_analysis": {
      "summary": "This is a summary of the call",
      "call_completion_summary": "This is a summary of the call completion",
      "call_completion": "This is a summary of the call completion",
      "task_completion_summary": "This is a summary of the task completion",
      "task_completion": "This is a summary of the task completion",
      "post_analysis_data": [
        {
          "name": "This is the name of the post analysis data",
          "value": "This is the value of the post analysis data"
        }
      ]
    },
    "protocol": "web",
    "call_id": "be8b84ed-16d8-459e-b71c-b0f54fce5ec1",
    "from_number": "+1234567890",
    "to_number": "+1234567890",
    "assistant_id": "217b769d-befe-47a2-83bc-b014c2e19ea5",
    "assistant_name": "Appointment Setter",
    "voice_id": "Puretalktts-e0c5f2f95332",
    "voice_name": "Gabrielle",
    "start_time": "2025-05-19T10:15:22.230876-04:00",
    "end_time": "2025-05-19T10:15:22.230876-04:00",
    "call_duration_seconds": 123,
    "call_type": "outgoing",
    "transcript": "This is the transcript of the call",
    "transcript_object": [
      {
        "role": "user",
        "content": "This is the content of the transcript",
        "function_name": "get_weather",
        "interrupted": false,
        "function_args": "{\"location\": \"New York\"}",
        "tool_calls": [],
        "turn_latency": {
          "latency": 1.5,
          "eou_delay": 0.2,
          "llm_latency": 0.8,
          "tts_latency": 0.5
        }
      }
    ],
    "status": "completed",
    "provider_call_id": "CA96878fe2501423e1f018a7ab6db5498b",
    "metadata": "This is the metadata of the call",
    "variables": [
      "<string>"
    ],
    "answered_by": "human",
    "call_recording_enabled": true,
    "call_recording_url": "https://api.puretalk.ai/api/calls/1234567890/recording",
    "campaign_id": "<string>",
    "sentiment": "positive",
    "is_billed": true
  }
}

Authorizations

X-API-KEY

string

header

required

Authorization header containing API key. You can find your API key in the dashboard under 'API Keys'.

Path Parameters

call_id

string

required

ID of call to return

Response

Call response

msg

string

A success message

Example:

"Success"

err

boolean

Indicates if there was an error

Example:

false

results

object

Show child attributes

results.call_analysis

object

The analysis of the call

Show child attributes

results.call_analysis.summary

string | null

A summary of the call

Example:

"This is a summary of the call"

results.call_analysis.call_completion_summary

string | null

A summary of the call completion

Example:

"This is a summary of the call completion"

results.call_analysis.call_completion

string | null

A summary of the call completion

Example:

"This is a summary of the call completion"

results.call_analysis.task_completion_summary

string | null

A summary of the task completion

Example:

"This is a summary of the task completion"

results.call_analysis.task_completion

string | null

A summary of the task completion

Example:

"This is a summary of the task completion"

results.call_analysis.post_analysis_data

object[] | null

Show child attributes

results.call_analysis.post_analysis_data.name

string

The name of the post analysis data

Example:

"This is the name of the post analysis data"

results.call_analysis.post_analysis_data.value

The value of the post analysis data

Example:

"This is the value of the post analysis data"

results.protocol

enum<string>

The protocol of the call

Available options:

twilio,

telnyx,

web

Example:

"web"

results.call_id

string

The ID of the call

Example:

"be8b84ed-16d8-459e-b71c-b0f54fce5ec1"

results.from_number

string | null

The originating phone number

Example:

"+1234567890"

results.to_number

string | null

The destination phone number

Example:

"+1234567890"

results.assistant_id

string

The ID of the assistant

Example:

"217b769d-befe-47a2-83bc-b014c2e19ea5"

results.assistant_name

string

The name of the assistant

Example:

"Appointment Setter"

results.voice_id

string

The ID of the voice

Example:

"Puretalktts-e0c5f2f95332"

results.voice_name

string

The name of the voice

Example:

"Gabrielle"

results.start_time

string<date-time>

The start time of the call

Example:

"2025-05-19T10:15:22.230876-04:00"

results.end_time

string<date-time> | null

The end time of the call

Example:

"2025-05-19T10:15:22.230876-04:00"

results.call_duration_seconds

integer | null

The duration of the call in seconds

Example:

123

results.call_type

enum<string>

The type of call

Available options:

incoming,

outgoing

Example:

"outgoing"

results.transcript

string | null

The transcript of the call

Example:

"This is the transcript of the call"

results.transcript_object

object[] | null

The transcript of the call

Show child attributes

results.transcript_object.role

string

Whether the role is user or assistant

Example:

"user"

results.transcript_object.content

string

The content of the transcript

Example:

"This is the content of the transcript"

results.transcript_object.function_name

string | null

The name of the function called

Example:

"get_weather"

results.transcript_object.interrupted

boolean

Whether the turn was interrupted

Example:

false

results.transcript_object.function_args

string | null

The arguments passed to the function

Example:

"{\"location\": \"New York\"}"

results.transcript_object.tool_calls

array

Array of tool calls made during the turn

Example:

[]

results.transcript_object.turn_latency

object

Latency metrics for the turn

Show child attributes

results.transcript_object.turn_latency.latency

number

Total latency for the turn

Example:

1.5

results.transcript_object.turn_latency.eou_delay

number

End of utterance delay

Example:

0.2

results.transcript_object.turn_latency.llm_latency

number

LLM processing latency

Example:

0.8

results.transcript_object.turn_latency.tts_latency

number

Text-to-speech latency

Example:

0.5

results.status

enum<string>

The status of the call

Available options:

completed,

in progress,

failed,

busy,

queued,

ringing,

in-progress,

no-answer,

canceled

Example:

"completed"

results.provider_call_id

string | null

The ID of the call from the provider

Example:

"CA96878fe2501423e1f018a7ab6db5498b"

results.metadata

object

The metadata of the call

Show child attributes

results.metadata.model

string

The model of the call

Example:

"gpt-3.5-turbo"

Example:

"This is the metadata of the call"

results.variables

string[]

results.answered_by

enum<string>

The name of the person who answered the call

Available options:

human,

machine

Example:

"human"

results.call_recording_enabled

boolean

Whether the call recording is enabled

Example:

true

results.call_recording_url

string<uri> | null

The URL of the call recording

Example:

"https://api.puretalk.ai/api/calls/1234567890/recording"

results.campaign_id

string | null

results.sentiment

enum<string> | null

The sentiment of the call

Available options:

positive,

negative,

neutral,

n/a

Example:

"positive"

results.is_billed

boolean

Whether the call is billed

Example:

true

Get Call List Get Integrations

⌘I

Voices

AI Assistants

Multi-Task Assistants

Phone Numbers

Calls

Ruth Connect

Campaigns

Account

TTS

Authorizations

Path Parameters

Response