Skip to main content
GET
/
contacts
/
{CONTACT_ID}
/
customer-interactions
cURL
curl --request GET \
  --url https://api.alpharun.com/api/v1/contacts/{CONTACT_ID}/customer-interactions \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.alpharun.com/api/v1/contacts/{CONTACT_ID}/customer-interactions"

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/contacts/{CONTACT_ID}/customer-interactions', 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/contacts/{CONTACT_ID}/customer-interactions",
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/contacts/{CONTACT_ID}/customer-interactions"

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/contacts/{CONTACT_ID}/customer-interactions")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.alpharun.com/api/v1/contacts/{CONTACT_ID}/customer-interactions")

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_interactions": [
      {
        "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
          }
        ],
        "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"
              }
            ]
          }
        ]
      }
    ]
  },
  "next_cursor": null
}
{
"error": 123,
"message": "<string>"
}
{
"error": 123,
"message": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

CONTACT_ID
string
required

The contact identifier, which can be either its UUID or its user-defined ext_id. When using the ext_id, the format should be alt:ext_id:<ext_id>.

Query Parameters

limit
integer
default:20

Maximum number of customer interactions to return in a single response. Defaults to 20. Must be between 1 and 100; values outside this range return a 400.

Required range: 1 <= x <= 100
cursor
string | null

Pagination cursor returned as next_cursor in a previous response. Omit on the first request.

Response

List of customer interactions for the contact's account

data
object
next_cursor
string | null

Cursor to pass as the cursor query parameter to fetch the next page. null when there are no more results.