cURL
curl --request GET \
--url https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}', 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.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}",
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.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}"
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.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}")
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": {
"customer_interaction": {
"id": "abc123",
"teammate": {
"id": "teammate123",
"email": "[email protected]"
},
"summary": "Customer called about a billing discrepancy on their March invoice. Agent confirmed a duplicate charge, issued a refund, and the customer was satisfied.",
"data_extraction_fields": [
{
"key": "customer_satisfaction_score",
"name": "Customer Satisfaction Score",
"type": "number",
"value": 4.5
},
{
"key": "issue_resolved",
"name": "Issue Resolved",
"type": "boolean",
"value": true
}
],
"custom_fields": [
{
"key": "priority",
"name": "Priority",
"type": "text",
"value": "high"
}
],
"account": {
"id": "account123",
"ext_id": "ext_account_456"
},
"contacts": [
{
"id": "contact123",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"phone_number": "+1234567890",
"ext_id": "ext_contact_789",
"custom_fields": [
{
"key": "preferred_contact_method",
"name": "Preferred Contact Method",
"type": "text",
"value": "email"
}
]
}
],
"analysis": [
{
"type": "section",
"name": "Discovery",
"is_applicable": true,
"commentary": "The agent covered the key discovery topics.",
"nodes": [
{
"type": "criteria",
"name": "Verified the customer's identity",
"value": "yes",
"commentary": "Agent confirmed the account holder before discussing billing."
},
{
"type": "criteria",
"name": "Identified the customer's primary issue",
"value": "yes",
"commentary": "Agent confirmed the duplicate charge on the March invoice."
}
]
}
],
"outcome": {
"name": "Resolution",
"value": "Resolved"
}
}
}
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}Call monitoring
Fetch Customer Interaction
Return the customer interaction for the given ID.
Pass include_analysis=true to additionally return the analysis (the section-by-section assessment of the interaction against its playbook) and outcome fields. These are omitted by default.
GET
/
customer-interactions
/
{CUSTOMER_INTERACTION_ID}
cURL
curl --request GET \
--url https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}', 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.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}",
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.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}"
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.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.alpharun.com/api/v1/customer-interactions/{CUSTOMER_INTERACTION_ID}")
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": {
"customer_interaction": {
"id": "abc123",
"teammate": {
"id": "teammate123",
"email": "[email protected]"
},
"summary": "Customer called about a billing discrepancy on their March invoice. Agent confirmed a duplicate charge, issued a refund, and the customer was satisfied.",
"data_extraction_fields": [
{
"key": "customer_satisfaction_score",
"name": "Customer Satisfaction Score",
"type": "number",
"value": 4.5
},
{
"key": "issue_resolved",
"name": "Issue Resolved",
"type": "boolean",
"value": true
}
],
"custom_fields": [
{
"key": "priority",
"name": "Priority",
"type": "text",
"value": "high"
}
],
"account": {
"id": "account123",
"ext_id": "ext_account_456"
},
"contacts": [
{
"id": "contact123",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"phone_number": "+1234567890",
"ext_id": "ext_contact_789",
"custom_fields": [
{
"key": "preferred_contact_method",
"name": "Preferred Contact Method",
"type": "text",
"value": "email"
}
]
}
],
"analysis": [
{
"type": "section",
"name": "Discovery",
"is_applicable": true,
"commentary": "The agent covered the key discovery topics.",
"nodes": [
{
"type": "criteria",
"name": "Verified the customer's identity",
"value": "yes",
"commentary": "Agent confirmed the account holder before discussing billing."
},
{
"type": "criteria",
"name": "Identified the customer's primary issue",
"value": "yes",
"commentary": "Agent confirmed the duplicate charge on the March invoice."
}
]
}
],
"outcome": {
"name": "Resolution",
"value": "Resolved"
}
}
}
}{
"error": 123,
"message": "<string>"
}{
"error": 123,
"message": "<string>"
}Building AI-powered analysis on top of interaction data? Use the Alpharun MCP server instead of exporting interactions into your own system. It gives AI assistants and agents live, queryable access to interactions, transcripts, and playbook analytics — including semantic transcript search — with no data pipeline to build or keep in sync. This endpoint is best for fetching specific records as part of a system integration, not for bulk-copying your Alpharun data.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID of the customer interaction to fetch
Query Parameters
When true, include the analysis and outcome fields in the response. Defaults to false, in which case both fields are omitted.
Response
Customer interaction details
Show child attributes
Show child attributes
⌘I