Fetch call history

curl --request GET \
  --url https://api.upon-ai.com/api/v1/calls/history \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.upon-ai.com/api/v1/calls/history', 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.upon-ai.com/api/v1/calls/history",
  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.upon-ai.com/api/v1/calls/history"

	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.upon-ai.com/api/v1/calls/history")

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

{
  "success": true,
  "calls": [
    {
      "callSid": "call_123abc",
      "callStatus": "ended",
      "agentId": "agent_456def",
      "agentVersion": 2,
      "agentName": "Concierge",
      "workspaceId": 42,
      "workspaceName": "Demo Workspace",
      "fromNumber": "+14155550100",
      "toNumber": "+14155550199",
      "direction": "outbound",
      "customerName": "Jane Doe",
      "duration": 214,
      "startedAt": "2026-03-12T14:22:00.000Z",
      "recordingUrl": "https://cdn.example.com/recordings/call_123abc.mp3",
      "sentiment": "positive",
      "summary": "Customer confirmed an appointment for Friday.",
      "costs": {
        "voice": 0.09,
        "llm": 0.03,
        "gross": 0.12,
        "total": 0.15
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 184,
    "pages": 10
  }
}

GET

api

calls

history

Fetch call history

curl --request GET \
  --url https://api.upon-ai.com/api/v1/calls/history \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.upon-ai.com/api/v1/calls/history', 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.upon-ai.com/api/v1/calls/history",
  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.upon-ai.com/api/v1/calls/history"

	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.upon-ai.com/api/v1/calls/history")

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

{
  "success": true,
  "calls": [
    {
      "callSid": "call_123abc",
      "callStatus": "ended",
      "agentId": "agent_456def",
      "agentVersion": 2,
      "agentName": "Concierge",
      "workspaceId": 42,
      "workspaceName": "Demo Workspace",
      "fromNumber": "+14155550100",
      "toNumber": "+14155550199",
      "direction": "outbound",
      "customerName": "Jane Doe",
      "duration": 214,
      "startedAt": "2026-03-12T14:22:00.000Z",
      "recordingUrl": "https://cdn.example.com/recordings/call_123abc.mp3",
      "sentiment": "positive",
      "summary": "Customer confirmed an appointment for Friday.",
      "costs": {
        "voice": 0.09,
        "llm": 0.03,
        "gross": 0.12,
        "total": 0.15
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 184,
    "pages": 10
  }
}

Authorizations

Authorization

string

header

required

Generate tokens from your profile settings at app.uponai.com.

Headers

X-Actor-Type

enum<string>

Optional actor type for privileged white-label context selection.

Available options:

platform_admin,

provider_admin,

tenant_admin,

end_user

X-Provider-Id

integer

Optional provider scope identifier for privileged multi-tenant access.

X-Tenant-Id

integer

Optional tenant/workspace context override.

X-Impersonation-Reason

string

Required for privileged tenant-scoped requests when actor type is platform or provider admin.

Query Parameters

workspaceId

integer

required

Workspace identifier. Call GET /api/workspaces to list workspaces accessible to your token.

agentId

string

Filter call listings to a specific agent.

agentVersion

integer

Filter call history to a specific persisted agent version captured at call time.

status

string

Filter calls by status.

string

Search by call SID, phone number, platform call ID, customer name, or agent name.

fromDate

string<date-time>

Inclusive start date for call listing filter.

toDate

string<date-time>

Inclusive end date for call listing filter.

page

integer

default:1

Required range: x >= 1

limit

integer

default:20

Page size for list endpoints.

Required range: 1 <= x <= 100

includeArchived

boolean

When true, include archived calls in the response.

includeChildCalls

boolean

When true, include child calls linked to transfer or split-call workflows.

Response

200 - application/json

Paginated call history.

success

boolean

calls

object[]

Show child attributes

pagination

object

Show child attributes

filters

object

Calls

LLM Models

Agents

Chat Agents

Chats

Conversation Flows

Knowledge Bases

Voices

Test Case Definitions

Test Runs

Account

Phone Numbers

Fetch call history

Authorizations

Headers

Query Parameters

Response