GET
/
calls
curl --request GET \
  --url https://api.puretalk.ai/api/calls \
  --header 'X-API-KEY: <api-key>'
{
  "count": 192,
  "next": "https://api.puretalk.ai/api/calls?page=2",
  "previous": "https://api.puretalk.ai/api/calls?page=1",
  "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'.

Query Parameters

page
integer

The page number to return

limit
integer

The maximum number of results to return

call_type
enum<string>

The type of call (e.g., incoming, outgoing)

Available options:
incoming,
outgoing
status
enum<string>

The status of the call (e.g., completed, in-progress)

Available options:
completed,
in-progress,
failed
voice_id
string

The ID of the voice used

assistant_id
string

The ID of the assistant

from_number
string

The originating phone number

to_number
string

The destination phone number

call_id
string

The ID of the call

protocol
enum<string>

The protocol of the call

Available options:
web,
voip
sentiment
enum<string>

The sentiment of the call

Available options:
positive,
negative,
neutral

Response

200
application/json

Calls response

The response is of type object.