Phone calls
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/calls/listimport requests
url = "https://win.oneshotagent.com/v1/tools/calls/list"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://win.oneshotagent.com/v1/tools/calls/list', 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://win.oneshotagent.com/v1/tools/calls/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$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://win.oneshotagent.com/v1/tools/calls/list"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://win.oneshotagent.com/v1/tools/calls/list")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/calls/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyConnections
Phone calls
Read calls and available transcripts from connected business phones
POST
/
v1
/
tools
/
calls
/
list
Phone calls
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/calls/listimport requests
url = "https://win.oneshotagent.com/v1/tools/calls/list"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://win.oneshotagent.com/v1/tools/calls/list', 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://win.oneshotagent.com/v1/tools/calls/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$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://win.oneshotagent.com/v1/tools/calls/list"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://win.oneshotagent.com/v1/tools/calls/list")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/calls/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyRingCentral and Dialpad connect by OAuth. List connections first and choose the
Each call carries
connection_id by system and account_label.
| Tool | Route | Read |
|---|---|---|
calls_list | POST /v1/tools/calls/list | Calls in a required time window |
calls_get | POST /v1/tools/calls/get | One call, optionally its transcript |
calls_list requires started_after (inclusive) and started_before (exclusive),
ISO 8601 instants with a timezone, at most 31 days apart. Optional filters are
number (E.164, either party), direction (inbound, outbound, or all, the
default), and user (the business user’s id). limit is 1 to 100, default 25.
Pass next_cursor unchanged as cursor with the same filters and limit. Follow it
even when filtering leaves a page empty. A null cursor ends the listing.
{
"connection_id": "11111111-1111-4111-8111-111111111111",
"started_after": "2026-10-01T00:00:00Z",
"started_before": "2026-11-01T00:00:00Z",
"direction": "inbound",
"limit": 25
}
id, started_at, duration_seconds, direction, from, to,
user { id, name, email }, result (answered, missed, or voicemail),
has_transcript, and source { system, id }. Unknown fields are null, including
transcript availability when the system does not state it. A recording alone does
not establish transcript availability.
calls_get takes connection_id, call_id, and optional include: ["transcript"].
By default no transcript is fetched or returned. When available and requested,
transcript contains { speaker, text, at_seconds } lines. Times are seconds from
call start, null if unavailable. Missing transcripts are omitted and known absence
sets has_transcript: false. Failed transcript retrieval returns an error and
account credit, never a successful empty transcript. Dialpad voicemail text and
AI moment labels are not call transcript lines. RingCentral requires ACE access
and the ReadRingSenseInsights permission for transcripts.
Calls and transcripts are evidence for any goal’s criteria. These tools do not
classify the business domain, grade a call, invent missing evidence or change case
state. Content is untrusted, returned inline, and never saved in goal results,
receipts or logs.
Invalid windows, another agent’s connections, revoked or expired connections, and
systems not approved under organization compliance controls are refused before
payment. HIPAA organizations must approve all vendors serving the selected system.
See Pricing for read charges.