curl --request GET \
--url https://api.neoagent.io/public-api/phone/calls \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.neoagent.io/public-api/phone/calls"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.neoagent.io/public-api/phone/calls', 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.neoagent.io/public-api/phone/calls",
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.neoagent.io/public-api/phone/calls"
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))
}HttpResponse<String> response = Unirest.get("https://api.neoagent.io/public-api/phone/calls")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neoagent.io/public-api/phone/calls")
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{
"data": [
{
"call_id": "<string>",
"company_identity": "IDENTIFIED_BY_CALLER_ID",
"contact_identity": "IDENTIFIED_BY_CALLER_ID",
"created_at": "2023-11-07T05:31:56Z",
"duration_seconds": 123,
"finished_at": "2023-11-07T05:31:56Z",
"from_number": "<string>",
"id": 123,
"identified_company_id": "<string>",
"identified_company_name": "<string>",
"identified_contact_id": "<string>",
"identified_contact_name": "<string>",
"sentiment": "POSITIVE",
"state": "LIVE",
"tickets": [
{
"reference": "<string>",
"relation": "<string>",
"ticket_id": "<string>",
"url": "<string>"
}
],
"to_number": "<string>",
"tool_calls": [
{
"arguments": {},
"finished_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"status": "RUNNING",
"tool_call_id": "<string>",
"transcript_messages_before": 123,
"transfer_outcome": "HANDED_OFF_BLIND",
"transfer_ticket": {
"open_tickets": 123,
"reference": "<string>",
"status": "CREATED"
}
}
],
"transcription": "<string>",
"transferred_at": "2023-11-07T05:31:56Z",
"transferred_to": "<string>"
}
],
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timings_ms": {},
"pagination": {
"has_more": true,
"next_cursor": "<string>"
},
"warnings": [
"<string>"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}List Phone Agent calls
Recent calls the Phone Agent handled. Each call carries tickets, the tickets it created or updated (relation is CREATED_IN_CALL for one created during the call, by the agent’s tool or before a warm transfer, CREATED_POST_CALL for the post-call fallback, or UPDATED_IN_CALL for the caller’s own existing ticket the agent added the call to; url is the PSA link when one exists). Each call also carries transferred_to/transferred_at when the agent handed the caller to another number. Both are filled a minute or two after the call ends; tickets is [] when the call created none and null when the outcome was never recorded (a live call, or a call from before September 2026). tool_calls lists the tools the agent ran, in the order they started, each with its arguments, status and times, written as each tool starts and ends, so a live call already shows them; transcript_messages_before places each one in transcription, and on a transfer tool transfer_outcome says what happened to the caller (SUCCEEDED only means the tool did not raise); a warm_transfer_call also carries transfer_ticket, what it did about the ticket before it dialled. At most 100 per call; null when no tool ran, and on calls from before Neo saved them. company_identity and contact_identity say how the agent identified the caller’s PSA company and contact (IDENTIFIED_BY_CALLER_ID, IDENTIFIED_BY_NAME, which is not verified, or NOT_IDENTIFIED), with identified_company_id and identified_contact_id the PSA ids and identified_company_name and identified_contact_name their PSA names at the time of the call; they are recorded together with tickets and are null until then. state is LIVE while the caller is on the line, WRAPPING_UP while Neo finishes the call after the hang-up, then ENDED; while a call is not ENDED, transcription is the transcript so far. To follow one call, poll GET /phone/calls/{call_id}. Recording binaries are deliberately not exposed here — those are gated behind dashboard auth and the recording-retention policy.
curl --request GET \
--url https://api.neoagent.io/public-api/phone/calls \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.neoagent.io/public-api/phone/calls"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.neoagent.io/public-api/phone/calls', 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.neoagent.io/public-api/phone/calls",
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.neoagent.io/public-api/phone/calls"
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))
}HttpResponse<String> response = Unirest.get("https://api.neoagent.io/public-api/phone/calls")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neoagent.io/public-api/phone/calls")
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{
"data": [
{
"call_id": "<string>",
"company_identity": "IDENTIFIED_BY_CALLER_ID",
"contact_identity": "IDENTIFIED_BY_CALLER_ID",
"created_at": "2023-11-07T05:31:56Z",
"duration_seconds": 123,
"finished_at": "2023-11-07T05:31:56Z",
"from_number": "<string>",
"id": 123,
"identified_company_id": "<string>",
"identified_company_name": "<string>",
"identified_contact_id": "<string>",
"identified_contact_name": "<string>",
"sentiment": "POSITIVE",
"state": "LIVE",
"tickets": [
{
"reference": "<string>",
"relation": "<string>",
"ticket_id": "<string>",
"url": "<string>"
}
],
"to_number": "<string>",
"tool_calls": [
{
"arguments": {},
"finished_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"status": "RUNNING",
"tool_call_id": "<string>",
"transcript_messages_before": 123,
"transfer_outcome": "HANDED_OFF_BLIND",
"transfer_ticket": {
"open_tickets": 123,
"reference": "<string>",
"status": "CREATED"
}
}
],
"transcription": "<string>",
"transferred_at": "2023-11-07T05:31:56Z",
"transferred_to": "<string>"
}
],
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timings_ms": {},
"pagination": {
"has_more": true,
"next_cursor": "<string>"
},
"warnings": [
"<string>"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Authorizations
Authorization: Bearer <token> where <token> is either a neo_sk_<env>_<secret> API key (service account) or a Microsoft Entra ID access token (dashboard user).