Get detailed contact stats

Detailed Contact Stats

curl --request GET \
  --url https://api.operata.io/v1/data/calls/{contactId}/details \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.operata.io/v1/data/calls/{contactId}/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.operata.io/v1/data/calls/{contactId}/details"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.operata.io/v1/data/calls/{contactId}/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

"[\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    }\n]"

"<html>\n\n<head>\n\t<title>401 Authorization Required</title>\n</head>\n\n<body>\n\t<center>\n\t\t<h1>401 Authorization Required</h1>\n\t</center>\n\t<hr>\n\t<center>nginx/1.19.2</center>\n</body>\n\n</html>"

"Call Summary record could not be found"

GET

data

calls

{contactId}

details

Detailed Contact Stats

curl --request GET \
  --url https://api.operata.io/v1/data/calls/{contactId}/details \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.operata.io/v1/data/calls/{contactId}/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.operata.io/v1/data/calls/{contactId}/details"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.operata.io/v1/data/calls/{contactId}/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

"[\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    },\n    {\n        \"agentStatus\": \"Talk\",\n        \"jitter\": 24,\n        \"mos\": 4.718968,\n        \"packetsReceived\": 50,\n        \"packetsSent\": 50,\n        \"rtt\": 58,\n        \"timestamp\": \"2020-09-07T22:39:39.272Z\"\n    }\n]"

"<html>\n\n<head>\n\t<title>401 Authorization Required</title>\n</head>\n\n<body>\n\t<center>\n\t\t<h1>401 Authorization Required</h1>\n\t</center>\n\t<hr>\n\t<center>nginx/1.19.2</center>\n</body>\n\n</html>"

"Call Summary record could not be found"

Returns the per-second network performance trace for one contact: jitter, round-trip time (RTT), MOS, packets sent and received, and agent status at each sample. Use it to chart call quality across the full duration of a contact — find the contactId first in List contact summaries.

Endpoint

GET https://api.operata.io/v1/data/calls/{contactId}/details

Parameters

Path

Name	Type	Required	Description
`contactId`	string	yes	The Amazon Connect Contact ID for the call.

Response

200 OK with an array of samples sorted by timestamp. Each sample covers one second of network metrics for the contact.

[
  {
    "agentStatus": "Talk",
    "jitter": 24,
    "mos": 4.72,
    "packetsReceived": 50,
    "packetsSent": 50,
    "rtt": 58,
    "timestamp": "2026-05-18T10:14:22.272Z"
  },
  {
    "agentStatus": "Talk",
    "jitter": 22,
    "mos": 4.75,
    "packetsReceived": 50,
    "packetsSent": 50,
    "rtt": 56,
    "timestamp": "2026-05-18T10:14:23.272Z"
  }
]

Field	Type	Description
`agentStatus`	string	`Talk` when the agent is unmuted, `Mute` when muted.
`jitter`	integer	Jitter for this sample, in milliseconds.
`mos`	number	Mean Opinion Score for this sample, 1.0–5.0. Higher is better.
`packetsReceived`	integer	Inbound packets in this one-second window.
`packetsSent`	integer	Outbound packets in this one-second window.
`rtt`	integer	Round-trip time for this sample, in milliseconds.
`timestamp`	string (ISO 8601)	UTC timestamp for the sample.

Sample count matches contact duration — one entry per second of active call. For aggregated min/avg/max values across the whole contact, use Get complete contact record.

Example

curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
  "https://api.operata.io/v1/data/calls/db248964-dad8-4da8-8ca4-8094d2d254c5/details"

const groupId = process.env.OPERATA_GROUP_ID;
const apiToken = process.env.OPERATA_API_TOKEN;
const auth = Buffer.from(`${groupId}:${apiToken}`).toString("base64");

const contactId = "db248964-dad8-4da8-8ca4-8094d2d254c5";
const response = await fetch(
  `https://api.operata.io/v1/data/calls/${contactId}/details`,
  { headers: { Authorization: `Basic ${auth}` } },
);
const samples = await response.json();

import os, requests

contact_id = "db248964-dad8-4da8-8ca4-8094d2d254c5"
response = requests.get(
    f"https://api.operata.io/v1/data/calls/{contact_id}/details",
    auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
)
response.raise_for_status()
samples = response.json()

Errors

Status	Code	When	Recover
404	`not_found`	No contact with `contactId` exists for this Operata account, or no per-second samples have arrived yet.	Confirm the ID against List contact summaries. If the contact ended within the last minute, retry after a short delay.

See Errors for shared codes such as 401 unauthorized, 429 rate_limited, and the 5xx family. For request caps see Rate limits.

Get complete contact record — every captured field for the same contact, including aggregated network metrics.
List contact summaries — list contacts to find a contactId to drill into.
Errors — shared status codes and recovery patterns.

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

contactId

string

default:none

required

Amazon Connect Contact ID

Response

200

agentStatus

string

Example:

"Talk"

jitter

integer

default:0

Example:

24

mos

number

default:0

Example:

4.718968

packetsReceived

integer

default:0

Example:

50

packetsSent

integer

default:0

Example:

50

rtt

integer

default:0

Example:

58

timestamp

string

Example:

"2020-09-07T22:39:39.272Z"

Get complete contact record

Query CCP logs

Overview & quickstart

API essentials

Endpoints — Contacts

Endpoints — Logs

Endpoints — Users

Endpoints — Data redaction

Events & webhooks

Streaming & backends

AI & MCP

Endpoint

Parameters

Path

Response

Example

Errors

Authorizations

Path Parameters

Response

​Endpoint

​Parameters

​Path

​Response

​Example

​Errors

​Related

Authorizations

Path Parameters

Response

Endpoint

Parameters

Path

Response

Example

Errors

Related