> ## Documentation Index
> Fetch the complete documentation index at: https://docs.operata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get complete contact record
> Fetch every Operata field captured for a single contact — softphone summary, Contact Trace Record (CTR), contact flow, headset analytics, and per-leg event timestamps.
Returns every Operata field captured for a single Amazon Connect contact: softphone summary, Contact Trace Record (CTR), contact flow modules, headset analytics, and per-leg event timestamps. You'll typically have the `contactId` from [List contact summaries](/docs/api-contact-summary).
## Endpoint
```http theme={null}
GET https://api.operata.io/v1/data/{contactId}
```
## Parameters
### Path
| Name | Type | Required | Description |
| ----------- | ------ | -------- | ------------------------------------------- |
| `contactId` | string | yes | The Amazon Connect Contact ID for the call. |
## Response
`200 OK` with one object containing every captured block for the contact. A block is absent when its telemetry hasn't arrived yet.
```json theme={null}
{
"contactFlowSummary": [
{
"contactFlowModuleType": "SetLoggingBehavior",
"timestamp": "2026-05-18T10:14:09.833Z"
}
],
"softphoneSummary": {
"contactId": "db248964-dad8-4da8-8ca4-8094d2d254c5",
"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,
"browser": { "name": "Chrome", "version": "124.0.6367.119" },
"operataClientInfo": {
"operataClientId": "client_acme",
"group": "ACME Limited"
},
"networkPerformanceMetrics": {
"jitter": { "min": 1, "avg": 12, "max": 30 },
"rtt": { "min": 63, "avg": 66, "max": 77 },
"packetLoss": { "min": 0, "avg": 1, "max": 2 },
"mos": { "min": 4.27, "avg": 4.32, "max": 4.40 }
}
},
"jabraSummary": {
"contactId": "db248964-dad8-4da8-8ca4-8094d2d254c5",
"agent": "agent_42",
"deviceInfo": {
"deviceName": "Jabra Engage 50",
"deviceConnection": "USB",
"firmwareVersion": "1.24.0",
"serialNumber": "000098577437"
},
"analytics": {
"totalSeconds": "93.23",
"txSpeechTotalPct": 0,
"rxSpeechTotalPct": 78.82,
"crossTalkTotalPct": 10.08,
"silenceTotalPct": 11.10
},
"timestamp": "2026-05-18T10:16:28.245Z"
},
"contactTraceSummary": {
"ContactId": "db248964-dad8-4da8-8ca4-8094d2d254c5",
"Channel": "VOICE",
"InitiationMethod": "INBOUND",
"InitiationTimestamp": "2026-05-18T10:14:09Z",
"DisconnectTimestamp": "2026-05-18T10:16:36Z",
"Agent": {
"Username": "agent_42",
"AgentInteractionDuration": 16
},
"Queue": { "Name": "billing-tier-1", "Duration": 7 }
},
"softphoneEvents": {
"initiated": "2026-05-18T10:14:09.213Z",
"connecting": "2026-05-18T10:14:19.213Z",
"connected": "2026-05-18T10:14:20.213Z",
"disconnected": "2026-05-18T10:16:23.213Z"
},
"operataBillingSummary": {
"agentInteractionDurationRoundedMin": 1,
"agentInteractionDurationActualSec": 16,
"operataStatsDurationRoundedMin": 2,
"operataStatsDurationSec": 103
},
"contactDurationSummary": {
"contactDurationRoundedMin": 1,
"contactDurationActualSec": 27
}
}
```
| Field | Type | Description |
| ------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `softphoneSummary` | object | Browser-side telemetry from the Agent Experience Collector. See [Machine, browser, network](/docs/machine-browser-network). |
| `contactFlowSummary` | array | Ordered list of contact-flow modules the contact passed through, with timestamps. |
| `contactTraceSummary` | object | The Amazon Connect Contact Trace Record. See [Contact trace records](/docs/contact-trace-records). |
| `jabraSummary` | object | Headset analytics for Jabra devices. See [Headset logs](/docs/headset-logs). Absent for non-Jabra headsets. |
| `softphoneEvents` | object | Lifecycle timestamps for the contact: `initiated`, `connecting`, `connected`, `disconnected`, `ended`. |
| `operataBillingSummary` | object | Durations Operata uses for billing rollups. |
| `contactDurationSummary` | object | Total contact duration in seconds and rounded minutes. |
Telemetry continues to arrive for a short window after the contact ends. Fetching immediately may return a `softphoneSummary` without the headset or contact-flow blocks — retry a few seconds later to get the complete record.
## Example
```bash curl theme={null}
curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
"https://api.operata.io/v1/data/db248964-dad8-4da8-8ca4-8094d2d254c5"
```
```javascript Node.js theme={null}
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/${contactId}`, {
headers: { Authorization: `Basic ${auth}` },
});
const record = await response.json();
```
```python Python theme={null}
import os, requests
contact_id = "db248964-dad8-4da8-8ca4-8094d2d254c5"
response = requests.get(
f"https://api.operata.io/v1/data/{contact_id}",
auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
)
response.raise_for_status()
record = response.json()
```
## Errors
| Status | Code | When | Recover |
| ------ | ----------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 404 | `not_found` | No contact with `contactId` exists for this Operata account, or telemetry has not landed yet. | Confirm the ID against [List contact summaries](/docs/api-contact-summary). If the contact ended within the last minute, retry after a short delay. |
See [Errors](/docs/api-errors) for shared codes such as `401 unauthorized`, `429 rate_limited`, and the `5xx` family.
## Related
* [List contact summaries](/docs/api-contact-summary) — find a `contactId` across a time window.
* [Get detailed contact stats](/docs/api-contact-stats) — second-by-second metrics for the same contact.
* [Contact trace records](/docs/contact-trace-records) — field reference for the CTR block.
* [Headset logs](/docs/headset-logs) — field reference for the `jabraSummary` block.
## OpenAPI
````yaml GET /v1/data/{contactId}
openapi: 3.0.3
info:
title: operata-api
version: '1'
servers:
- url: https://api.operata.io/
security:
- sec0: []
paths:
/v1/data/{contactId}:
get:
summary: Complete Contact Record
description: >-
Returns complete Operata data, Contact Trace Record & Contact Flow
Record
operationId: operata-metrics
parameters:
- name: contactId
in: path
description: Amazon Connect `Contact ID` for the call
schema:
type: string
required: true
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: |2-
],
"softphoneSummary": {
"contactId": "db248964-dad8-4da8-8ca4-8094d2d254c5",
"agentUserName": "james",
"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,
"browser": {
"name": "Chrome",
"version": "81.0.4044.122"
},
"operataClientInfo": {
"operataClientId": "xxxxx",
"group": "ACME Limited"
},
"iceServers": [
{
"country": "Australia",
"city": "Sydney",
"region": "New South Wales",
"protocol": "udp",
"port": "3478",
"turnIpAddress": "turnnlb-93f2de0c97c4316b.elb.ap-southeast-2.amazonaws.com."
}
],
"operataCustomAttributes": [
{
"key": "Operata_App_ID",
"value": ""
},
{
"key": "Location",
"value": "Default"
},
{
"key": "Provider",
"value": ""
}
],
"networkPerformanceMetrics": {
"jitter": {
"min": 1,
"avg": 12,
"max": 30
},
"rtt": {
"min": 63,
"avg": 66,
"max": 77
},
"packetLoss": {
"min": 0,
"avg": 1,
"max": 2
},
"mos": {
"min": 4.265032286010377,
"avg": 0.9612324864117338,
"max": 4.400265513005151
},
"totals": {
"bytesReceived": 447283,
"bytesSent": 480531,
"packetsLost": 0,
"packetsSent": 0,
"packetsReceived": 0
}
}
},
"jabraSummary": {
"agent": "gina",
"analytics": {
"crossTalkTotal": "9.40",
"crossTalkTotalPct": 10.08,
"rxSpeechTotal": "73.48",
"rxSpeechTotalPct": 78.82,
"silenceTotal": "10.35",
"silenceTotalPct": 11.1,
"totalSeconds": "93.23",
"txSpeechTotal": "0.00",
"txSpeechTotalPct": 0
},
"contactId": "db248964-dad8-4da8-8ca4-8094d2d254c5",
"deviceInfo": {
"deviceConnection": "USB",
"deviceName": "Jabra Engage 50",
"errStatus": 0,
"firmwareVersion": "1.24.0",
"serialNumber": "000098577437"
},
"status": {
"audioExposure": {
"avg": 49,
"max": 56,
"min": 69
},
"backgroundNoise": {
"avg": 89,
"max": 60,
"min": 21
},
"boomArm": {},
"muteCount": 2,
"volUpDownCount": 4
},
"timestamp": "2020-09-07T22:31:28.245Z"
},
"contactTraceSummary": {
"AWSAccountId": "08123456789",
"AWSContactTraceRecordFormatVersion": "2017-03-10",
"Agent": {
"ARN": "arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7bxasasas/agent/f33f0475-5491-4add-a50a-a9b05b35b656",
"AfterContactWorkDuration": 3,
"AfterContactWorkEndTimestamp": "2020-08-10T00:16:39Z",
"AfterContactWorkStartTimestamp": "2020-08-10T00:16:36Z",
"AgentInteractionDuration": 16,
"ConnectedToAgentTimestamp": "2020-08-10T00:16:20Z",
"CustomerHoldDuration": 0,
"LongestHoldDuration": 0,
"NumberOfHolds": 0,
"RoutingProfile": {
"ARN": "arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7b9193b0/routing-profile/a25ae2ec-b30d-4fe7-9ecc-7b560d851ec6",
"Name": "Joey_RP"
},
"Username": "joey"
},
"AgentConnectionAttempts": 1,
"Attributes": {},
"Channel": "VOICE",
"ConnectedToSystemTimestamp": "2020-08-10T00:16:09Z",
"ContactId": "8b23a256-1c29-4769-a5a3-65b5d09da0e8",
"CustomerEndpoint": {
"Address": "+61430036126",
"Type": "TELEPHONE_NUMBER"
},
"DisconnectTimestamp": "2020-08-10T00:16:36Z",
"InitiationMethod": "INBOUND",
"InitiationTimestamp": "2020-08-10T00:16:09Z",
"InstanceARN": "arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7b9193b0",
"LastUpdateTimestamp": "2020-08-10T00:17:43Z",
"MediaStreams": [
{
"Type": "AUDIO"
}
],
"Queue": {
"ARN": "arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7b9193b0/queue/bc2e05c0-71f6-4804-81f4-23d0e5591f27",
"DequeueTimestamp": "2020-08-10T00:16:20Z",
"Duration": 7,
"EnqueueTimestamp": "2020-08-10T00:16:13Z",
"Name": "Operata Service"
},
"Recording": {
"Location": "path.to.recording/connect/path/2020/08/10/8b23a256-1c29-4769-a5a3-65b5d09da0e8_20200810T00:16_UTC.wav",
"Status": "AVAILABLE",
"Type": "AUDIO"
},
"Recordings": [
{
"Location": "path.to.recording/connect/path/2020/08/10/8b23a256-1c29-4769-a5a3-65b5d09da0e8_20200810T00:16_UTC.wav",
"MediaStreamType": "AUDIO",
"Status": "AVAILABLE",
"StorageType": "S3"
}
],
"SystemEndpoint": {
"Address": "+61390685102",
"Type": "TELEPHONE_NUMBER"
}
},
"softphoneEvents": {
"initiated": "2020-09-07T22:29:23.213Z",
"incoming": "2020-09-07T22:29:33.213Z",
"connecting": "2020-09-07T22:29:39.213Z",
"connected": "2020-09-07T22:29:40.213Z",
"disconnected": "2020-09-07T22:31:23.213Z",
"ended": {
"party": "Agent",
"timestamp": "2020-09-07T22:31:23.213Z"
}
},
"operataBillingSummary": {
"agentInteractionDurationRoundedMin": 1,
"agentInteractionDurationActualSec": 16,
"operataStatsDurationRoundedMin": 2,
"operataStatsDurationSec": 103
},
"contactDurationSummary": {
"contactDurationRoundedMin": 1,
"contactDurationActualSec": 27
}
}
schema:
type: object
properties:
contactFlowSummary:
type: array
items:
type: object
properties:
contactFlowModuleType:
type: string
example: SetLoggingBehavior
timestamp:
type: string
example: '2020-08-10T00:16:09.833Z'
softphoneSummary:
type: object
properties:
contactId:
type: string
example: db248964-dad8-4da8-8ca4-8094d2d254c5
agentUserName:
type: string
example: james
agentCity:
type: string
example: Sydney
agentRegion:
type: string
example: New South Wales
agentCountry:
type: string
example: Australia
agentISP:
type: string
example: Google LLC
agentExternalIPAddress:
type: string
example: 35.197.161.176
agentLocalIPAddress:
type: string
example: 192.168.1.12
networkType:
type: string
example: wlan
protocol:
type: string
example: udp
port:
type: integer
example: 52500
default: 0
browser:
type: object
properties:
name:
type: string
example: Chrome
version:
type: string
example: 81.0.4044.122
operataClientInfo:
type: object
properties:
operataClientId:
type: string
example: xxxxx
group:
type: string
example: ACME Limited
iceServers:
type: array
items:
type: object
properties:
country:
type: string
example: Australia
city:
type: string
example: Sydney
region:
type: string
example: New South Wales
protocol:
type: string
example: udp
port:
type: string
example: '3478'
turnIpAddress:
type: string
example: >-
turnnlb-93f2de0c97c4316b.elb.ap-southeast-2.amazonaws.com.
operataCustomAttributes:
type: array
items:
type: object
properties:
key:
type: string
example: Operata_App_ID
value:
type: string
example: ''
networkPerformanceMetrics:
type: object
properties:
jitter:
type: object
properties:
min:
type: integer
example: 1
default: 0
avg:
type: integer
example: 12
default: 0
max:
type: integer
example: 30
default: 0
rtt:
type: object
properties:
min:
type: integer
example: 63
default: 0
avg:
type: integer
example: 66
default: 0
max:
type: integer
example: 77
default: 0
packetLoss:
type: object
properties:
min:
type: integer
example: 0
default: 0
avg:
type: integer
example: 1
default: 0
max:
type: integer
example: 2
default: 0
mos:
type: object
properties:
min:
type: number
example: 4.265032286010377
default: 0
avg:
type: number
example: 0.9612324864117338
default: 0
max:
type: number
example: 4.400265513005151
default: 0
totals:
type: object
properties:
bytesReceived:
type: integer
example: 447283
default: 0
bytesSent:
type: integer
example: 480531
default: 0
packetsLost:
type: integer
example: 0
default: 0
packetsSent:
type: integer
example: 0
default: 0
packetsReceived:
type: integer
example: 0
default: 0
jabraSummary:
type: object
properties:
agent:
type: string
example: gina
analytics:
type: object
properties:
crossTalkTotal:
type: string
example: '9.40'
crossTalkTotalPct:
type: number
example: 10.08
default: 0
rxSpeechTotal:
type: string
example: '73.48'
rxSpeechTotalPct:
type: number
example: 78.82
default: 0
silenceTotal:
type: string
example: '10.35'
silenceTotalPct:
type: number
example: 11.1
default: 0
totalSeconds:
type: string
example: '93.23'
txSpeechTotal:
type: string
example: '0.00'
txSpeechTotalPct:
type: integer
example: 0
default: 0
contactId:
type: string
example: db248964-dad8-4da8-8ca4-8094d2d254c5
deviceInfo:
type: object
properties:
deviceConnection:
type: string
example: USB
deviceName:
type: string
example: Jabra Engage 50
errStatus:
type: integer
example: 0
default: 0
firmwareVersion:
type: string
example: 1.24.0
serialNumber:
type: string
example: '000098577437'
status:
type: object
properties:
audioExposure:
type: object
properties:
avg:
type: integer
example: 49
default: 0
max:
type: integer
example: 56
default: 0
min:
type: integer
example: 69
default: 0
backgroundNoise:
type: object
properties:
avg:
type: integer
example: 89
default: 0
max:
type: integer
example: 60
default: 0
min:
type: integer
example: 21
default: 0
boomArm:
type: object
properties: {}
muteCount:
type: integer
example: 2
default: 0
volUpDownCount:
type: integer
example: 4
default: 0
timestamp:
type: string
example: '2020-09-07T22:31:28.245Z'
contactTraceSummary:
type: object
properties:
AWSAccountId:
type: string
example: '08123456789'
AWSContactTraceRecordFormatVersion:
type: string
example: '2017-03-10'
Agent:
type: object
properties:
ARN:
type: string
example: >-
arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7bxasasas/agent/f33f0475-5491-4add-a50a-a9b05b35b656
AfterContactWorkDuration:
type: integer
example: 3
default: 0
AfterContactWorkEndTimestamp:
type: string
example: '2020-08-10T00:16:39Z'
AfterContactWorkStartTimestamp:
type: string
example: '2020-08-10T00:16:36Z'
AgentInteractionDuration:
type: integer
example: 16
default: 0
ConnectedToAgentTimestamp:
type: string
example: '2020-08-10T00:16:20Z'
CustomerHoldDuration:
type: integer
example: 0
default: 0
LongestHoldDuration:
type: integer
example: 0
default: 0
NumberOfHolds:
type: integer
example: 0
default: 0
RoutingProfile:
type: object
properties:
ARN:
type: string
example: >-
arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7b9193b0/routing-profile/a25ae2ec-b30d-4fe7-9ecc-7b560d851ec6
Name:
type: string
example: Joey_RP
Username:
type: string
example: joey
AgentConnectionAttempts:
type: integer
example: 1
default: 0
Attributes:
type: object
properties: {}
Channel:
type: string
example: VOICE
ConnectedToSystemTimestamp:
type: string
example: '2020-08-10T00:16:09Z'
ContactId:
type: string
example: 8b23a256-1c29-4769-a5a3-65b5d09da0e8
CustomerEndpoint:
type: object
properties:
Address:
type: string
example: '+61430036126'
Type:
type: string
example: TELEPHONE_NUMBER
DisconnectTimestamp:
type: string
example: '2020-08-10T00:16:36Z'
InitiationMethod:
type: string
example: INBOUND
InitiationTimestamp:
type: string
example: '2020-08-10T00:16:09Z'
InstanceARN:
type: string
example: >-
arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7b9193b0
LastUpdateTimestamp:
type: string
example: '2020-08-10T00:17:43Z'
MediaStreams:
type: array
items:
type: object
properties:
Type:
type: string
example: AUDIO
Queue:
type: object
properties:
ARN:
type: string
example: >-
arn:aws:connect:ap-southeast-2:08123456789:instance/ce9ff856-215b-4927-8953-c69f7b9193b0/queue/bc2e05c0-71f6-4804-81f4-23d0e5591f27
DequeueTimestamp:
type: string
example: '2020-08-10T00:16:20Z'
Duration:
type: integer
example: 7
default: 0
EnqueueTimestamp:
type: string
example: '2020-08-10T00:16:13Z'
Name:
type: string
example: Operata Service
Recording:
type: object
properties:
Location:
type: string
example: >-
path.to.recording/connect/path/2020/08/10/8b23a256-1c29-4769-a5a3-65b5d09da0e8_20200810T00:16_UTC.wav
Status:
type: string
example: AVAILABLE
Type:
type: string
example: AUDIO
Recordings:
type: array
items:
type: object
properties:
Location:
type: string
example: >-
path.to.recording/connect/path/2020/08/10/8b23a256-1c29-4769-a5a3-65b5d09da0e8_20200810T00:16_UTC.wav
MediaStreamType:
type: string
example: AUDIO
Status:
type: string
example: AVAILABLE
StorageType:
type: string
example: S3
SystemEndpoint:
type: object
properties:
Address:
type: string
example: '+61390685102'
Type:
type: string
example: TELEPHONE_NUMBER
softphoneEvents:
type: object
properties:
initiated:
type: string
example: '2020-09-07T22:29:23.213Z'
incoming:
type: string
example: '2020-09-07T22:29:33.213Z'
connecting:
type: string
example: '2020-09-07T22:29:39.213Z'
connected:
type: string
example: '2020-09-07T22:29:40.213Z'
disconnected:
type: string
example: '2020-09-07T22:31:23.213Z'
ended:
type: object
properties:
party:
type: string
example: Agent
timestamp:
type: string
example: '2020-09-07T22:31:23.213Z'
operataBillingSummary:
type: object
properties:
agentInteractionDurationRoundedMin:
type: integer
example: 1
default: 0
agentInteractionDurationActualSec:
type: integer
example: 16
default: 0
operataStatsDurationRoundedMin:
type: integer
example: 2
default: 0
operataStatsDurationSec:
type: integer
example: 103
default: 0
contactDurationSummary:
type: object
properties:
contactDurationRoundedMin:
type: integer
example: 1
default: 0
contactDurationActualSec:
type: integer
example: 27
default: 0
'401':
description: '401'
content:
text/plain:
examples:
Result:
value: "\n\n\n\t401 Authorization Required\n\n\n\n\t\n\t\t401 Authorization Required
\n\t\n\t
\n\tnginx/1.19.2\n\n\n"
'404':
description: '404'
content:
text/plain:
examples:
Result:
value: Call Summary record could not be found
deprecated: false
components:
securitySchemes:
sec0:
type: http
scheme: basic
````