List contact summaries

Contact Summary

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

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

fetch('https://api.operata.io/v1/data/calls', 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"

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"

	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        \"softphoneSummary\": {\n            \"contactId\": \"6347b169-063f-48f1-8d2e-001204be6677\",\n            \"agentUserName\": \"gabriela\",\n            \"agentCity\": \"Sydney\",\n            \"agentRegion\": \"New South Wales\",\n            \"agentCountry\": \"Australia\",\n            \"agentISP\": \"Google LLC\",\n            \"agentExternalIPAddress\": \"35.197.161.176\",\n            \"agentLocalIPAddress\": \"192.168.1.12\",\n            \"networkType\": \"wlan\",\n            \"protocol\": \"udp\",\n            \"port\": 52500,\n            \"networkPerformanceMetrics\": {\n                \"jitter\": {\n                    \"min\": 1,\n                    \"avg\": 73,\n                    \"max\": 30\n                },\n                \"rtt\": {\n                    \"min\": 63,\n                    \"avg\": 75,\n                    \"max\": 77\n                },\n                \"packetLoss\": {\n                    \"min\": 0,\n                    \"avg\": 1,\n                    \"max\": 2\n                },\n                \"mos\": {\n                    \"min\": 4.265032286010377,\n                    \"avg\": 2.250246744910879,\n                    \"max\": 4.400265513005151\n                },\n                \"totals\": {\n                    \"bytesReceived\": 447283,\n                    \"bytesSent\": 480531,\n                    \"packetsLost\": 0,\n                    \"packetsSent\": 0,\n                    \"packetsReceived\": 0\n                }\n            }\n        },\n        \"operataBillingSummary\": {\n            \"agentInteractionDurationRoundedMin\": 1,\n            \"agentInteractionDurationActualSec\": 16,\n            \"operataStatsDurationRoundedMin\": 2,\n            \"operataStatsDurationSec\": 103\n        },\n        \"contactDurationSummary\": {\n            \"contactDurationRoundedMin\": 1,\n            \"contactDurationActualSec\": 27\n        }\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

Contact Summary

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

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

fetch('https://api.operata.io/v1/data/calls', 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"

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"

	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        \"softphoneSummary\": {\n            \"contactId\": \"6347b169-063f-48f1-8d2e-001204be6677\",\n            \"agentUserName\": \"gabriela\",\n            \"agentCity\": \"Sydney\",\n            \"agentRegion\": \"New South Wales\",\n            \"agentCountry\": \"Australia\",\n            \"agentISP\": \"Google LLC\",\n            \"agentExternalIPAddress\": \"35.197.161.176\",\n            \"agentLocalIPAddress\": \"192.168.1.12\",\n            \"networkType\": \"wlan\",\n            \"protocol\": \"udp\",\n            \"port\": 52500,\n            \"networkPerformanceMetrics\": {\n                \"jitter\": {\n                    \"min\": 1,\n                    \"avg\": 73,\n                    \"max\": 30\n                },\n                \"rtt\": {\n                    \"min\": 63,\n                    \"avg\": 75,\n                    \"max\": 77\n                },\n                \"packetLoss\": {\n                    \"min\": 0,\n                    \"avg\": 1,\n                    \"max\": 2\n                },\n                \"mos\": {\n                    \"min\": 4.265032286010377,\n                    \"avg\": 2.250246744910879,\n                    \"max\": 4.400265513005151\n                },\n                \"totals\": {\n                    \"bytesReceived\": 447283,\n                    \"bytesSent\": 480531,\n                    \"packetsLost\": 0,\n                    \"packetsSent\": 0,\n                    \"packetsReceived\": 0\n                }\n            }\n        },\n        \"operataBillingSummary\": {\n            \"agentInteractionDurationRoundedMin\": 1,\n            \"agentInteractionDurationActualSec\": 16,\n            \"operataStatsDurationRoundedMin\": 2,\n            \"operataStatsDurationSec\": 103\n        },\n        \"contactDurationSummary\": {\n            \"contactDurationRoundedMin\": 1,\n            \"contactDurationActualSec\": 27\n        }\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"

Query a time window and get a page of contacts with summary metrics — agent, location, network performance, MOS, and contact duration. Use it to power listing views, scheduled exports, or threshold-based alerting before drilling into the full record per contact.

Endpoint

GET https://api.operata.io/v1/data/calls

Parameters

Query

Name	Type	Required	Description
`fromTime`	string (ISO 8601)	yes	Inclusive lower bound. UTC.
`toTime`	string (ISO 8601)	yes	Exclusive upper bound. UTC.
`cursor`	string	no	Opaque pagination cursor. See Pagination.
`size`	integer	no	Page size. 1–100. Default 50. See Pagination.
`contactId`	string	no	Filter to a single Amazon Connect Contact ID.
`networkType`	string	no	Filter by network type, for example `wlan` or `ethernet`.
`agentCity`	string	no	Filter by the agent’s geolocated city.
`agentStatus`	string	no	Filter by agent status during the contact: `Talk` or `Mute`.
`mosFrom`	number	no	Inclusive lower bound on average MOS. Send with `mosTo`.
`mosTo`	number	no	Inclusive upper bound on average MOS. Send with `mosFrom`.
`jitterFrom`	integer	no	Inclusive lower bound on average jitter in milliseconds. Send with `jitterTo`.
`jitterTo`	integer	no	Inclusive upper bound on average jitter in milliseconds. Send with `jitterFrom`.
`rttFrom`	integer	no	Inclusive lower bound on average round-trip time in milliseconds. Send with `rttTo`.
`rttTo`	integer	no	Inclusive upper bound on average round-trip time in milliseconds. Send with `rttFrom`.
`packetsLostFrom`	integer	no	Inclusive lower bound on packets lost. Send with `packetsLostTo`.
`packetsLostTo`	integer	no	Inclusive upper bound on packets lost. Send with `packetsLostFrom`.

Range filters (mos*, jitter*, rtt*, packetsLost*) require both ends in the same request.

Response

200 OK with a paginated envelope. Each entry in data[] summarizes one contact.

{
  "data": [
    {
      "softphoneSummary": {
        "contactId": "6347b169-063f-48f1-8d2e-001204be6677",
        "agentUserName": "agent_42",
        "agentCity": "Sydney",
        "agentRegion": "New South Wales",
        "agentCountry": "Australia",
        "agentISP": "Google LLC",
        "agentExternalIPAddress": "35.197.161.176",
        "agentLocalIPAddress": "192.168.1.12",
        "networkType": "wlan",
        "protocol": "udp",
        "port": 52500,
        "networkPerformanceMetrics": {
          "jitter": { "min": 1, "avg": 12, "max": 30 },
          "rtt": { "min": 63, "avg": 75, "max": 77 },
          "packetLoss": { "min": 0, "avg": 1, "max": 2 },
          "mos": { "min": 4.27, "avg": 4.32, "max": 4.40 },
          "totals": {
            "bytesReceived": 447283,
            "bytesSent": 480531,
            "packetsLost": 0,
            "packetsSent": 0,
            "packetsReceived": 0
          }
        }
      },
      "operataBillingSummary": {
        "agentInteractionDurationRoundedMin": 1,
        "agentInteractionDurationActualSec": 16,
        "operataStatsDurationRoundedMin": 2,
        "operataStatsDurationSec": 103
      },
      "contactDurationSummary": {
        "contactDurationRoundedMin": 1,
        "contactDurationActualSec": 27
      }
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ=="
}

Field	Type	Description
`data[].softphoneSummary`	object	Agent, location, network, and call-quality metrics captured by the Agent Experience Collector.
`data[].softphoneSummary.contactId`	string	Amazon Connect Contact ID. Pair with Contact record or Contact stats.
`data[].operataBillingSummary`	object	Durations Operata uses for billing rollups.
`data[].contactDurationSummary`	object	Total contact duration in seconds and rounded minutes.
`next_cursor`	string \| null	Cursor for the next page, or `null` at the end. See Pagination.

Example

Fetch the first page of a 24-hour window, then advance to the next page using the returned cursor.

# First page.
curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
  "https://api.operata.io/v1/data/calls?fromTime=2026-05-17T00:00:00Z&toTime=2026-05-18T00:00:00Z&size=50"

# Next page — copy `next_cursor` from the previous response.
curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
  "https://api.operata.io/v1/data/calls?cursor=eyJvZmZzZXQiOjUwfQ%3D%3D&size=50"

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

const url = new URL("https://api.operata.io/v1/data/calls");
url.searchParams.set("fromTime", "2026-05-17T00:00:00Z");
url.searchParams.set("toTime", "2026-05-18T00:00:00Z");
url.searchParams.set("size", "50");

const response = await fetch(url, {
  headers: { Authorization: `Basic ${auth}` },
});
const { data, next_cursor: nextCursor } = await response.json();

import os, requests

response = requests.get(
    "https://api.operata.io/v1/data/calls",
    auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
    params={
        "fromTime": "2026-05-17T00:00:00Z",
        "toTime": "2026-05-18T00:00:00Z",
        "size": 50,
    },
)
response.raise_for_status()
body = response.json()

Errors

Status	Code	When	Recover
400	`invalid_range`	`toTime` is missing, equal to, or before `fromTime`.	Send a window where `toTime` is strictly after `fromTime`.
400	`invalid_cursor`	The cursor is malformed or was issued by a different query.	Restart from the first page with the same filters. See Pagination.
404	`not_found`	No contact summary records match the window or filters.	Widen the window or remove a filter.

See Errors for shared codes such as 401 unauthorized, 429 rate_limited, and the 5xx family.

Authorizations

Authorization

string

header

required

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

Query Parameters

size

string

default:none

Page size

from

string

default:none

Record offset

fromTime

string

default:none

From Time

toTime

string

default:none

To Time

networkType

string

default:none

Network Type

contactId

string

default:none

Amazon Connect Contact ID

agentCity

string

default:none

Agent City

mosFrom

string

default:none

MOS From value (Both from and to values should present)

mosTo

string

default:none

MOS To value (Both from and to values should present)

jitterFrom

string

default:none

Jitter From value (Both from and to values should present)

jitterTo

string

default:none

Jitter To value (Both from and to values should present)

rttFrom

string

default:none

RTT From value (Both from and to values should present)

rttTo

string

default:none

RTT To value (Both from and to values should present)

packetsLostFrom

string

default:none

Packets Lost From value (Both from and to values should present)

packetsLostTo

string

default:none

Packets Lost To value(Both from and to values should present)

agentStatus

string

default:none

Agent Status (Talk/Mute)

Response

200

softphoneSummary

object

Show child attributes

operataBillingSummary

object

Show child attributes

contactDurationSummary

object

Show child attributes

Versioning

Get complete contact record

Overview & quickstart

API essentials

Endpoints — Contacts

Endpoints — Logs

Endpoints — Users

Endpoints — Data redaction

Events & webhooks

Streaming & backends

AI & MCP

Endpoint

Parameters

Query

Response

Example

Errors

Authorizations

Query Parameters

Response

​Endpoint

​Parameters

​Query

​Response

​Example

​Errors

Authorizations

Query Parameters

Response

Endpoint

Parameters

Query

Response

Example

Errors