Query CCP logs

CCP Logs

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

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

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

import requests

url = "https://api.operata.io/v1/data/ccpLogs"

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/ccpLogs"

	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        \"agent\": \"zoe\",\n        \"component\": \"ccp\",\n        \"exception\": null,\n        \"level\": \"TRACE\",\n        \"line\": 0,\n        \"loggerId\": \"1610928002159-lbngq11trj\",\n        \"objects\": [\n            {\n                \"nextToken\": null,\n                \"permissions\": [\n                    \"outboundCall\"\n                ]\n            }\n        ],\n        \"text\": \"AWSClient: <-- Operation 'getAgentPermissions' succeeded.\",\n        \"time\": \"2021-01-18T00:01:02.577Z\"\n    },"

"{}"

GET

data

ccpLogs

CCP Logs

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

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

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

import requests

url = "https://api.operata.io/v1/data/ccpLogs"

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/ccpLogs"

	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        \"agent\": \"zoe\",\n        \"component\": \"ccp\",\n        \"exception\": null,\n        \"level\": \"TRACE\",\n        \"line\": 0,\n        \"loggerId\": \"1610928002159-lbngq11trj\",\n        \"objects\": [\n            {\n                \"nextToken\": null,\n                \"permissions\": [\n                    \"outboundCall\"\n                ]\n            }\n        ],\n        \"text\": \"AWSClient: <-- Operation 'getAgentPermissions' succeeded.\",\n        \"time\": \"2021-01-18T00:01:02.577Z\"\n    },"

"{}"

Returns raw Contact Control Panel (CCP) log entries that the Agent Experience Collector forwarded to Operata. Use it to inspect agent-side errors, softphone state transitions, and timing for a single agent across a time window.

Endpoint

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

Parameters

Query

Name	Type	Required	Description
`criteria`	string (JSON)	yes	JSON object encoding the filter for this query. Url-encode the whole value. Supports `agent` (string), `fromTime` and `toTime` (ISO 8601 UTC).

The criteria value is a JSON object passed as a single query-string parameter. For example, {"agent":"agent_42","fromTime":"2026-05-18T00:00:00Z","toTime":"2026-05-18T01:00:00Z"} becomes

criteria=%7B%22agent%22%3A%22agent_42%22%2C%22fromTime%22%3A%222026-05-18T00%3A00%3A00Z%22%2C%22toTime%22%3A%222026-05-18T01%3A00%3A00Z%22%7D

Response

200 OK with an array of CCP log entries, ordered by time.

[
  {
    "agent": "agent_42",
    "component": "ccp",
    "exception": null,
    "level": "TRACE",
    "line": 0,
    "loggerId": "1747526402159-lbngq11trj",
    "objects": [
      { "nextToken": null, "permissions": ["outboundCall"] }
    ],
    "text": "AWSClient: <-- Operation 'getAgentPermissions' succeeded.",
    "time": "2026-05-18T00:01:02.577Z"
  }
]

Field	Type	Description
`agent`	string	Agent username the log entry came from.
`component`	string	CCP subsystem that emitted the entry. Typical values: `ccp`, `softphone`.
`level`	string	Log level: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`.
`exception`	string \| null	Stack or exception text when the entry is an error. `null` otherwise.
`loggerId`	string	The CCP logger instance that emitted the entry.
`objects`	array	Structured payload the CCP attached to the entry, when present.
`text`	string	Human-readable log message.
`time`	string (ISO 8601)	UTC timestamp the entry was emitted.

CCP log capture requires the Agent Experience Collector to be running in the agent’s browser. Entries from a session in progress may not appear until that session ends.

Example

CRITERIA='{"agent":"agent_42","fromTime":"2026-05-18T00:00:00Z","toTime":"2026-05-18T01:00:00Z"}'
curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
  --get "https://api.operata.io/v1/data/ccpLogs" \
  --data-urlencode "criteria=$CRITERIA"

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

const criteria = JSON.stringify({
  agent: "agent_42",
  fromTime: "2026-05-18T00:00:00Z",
  toTime: "2026-05-18T01:00:00Z",
});

const url = new URL("https://api.operata.io/v1/data/ccpLogs");
url.searchParams.set("criteria", criteria);

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

import json, os, requests

criteria = json.dumps({
    "agent": "agent_42",
    "fromTime": "2026-05-18T00:00:00Z",
    "toTime": "2026-05-18T01:00:00Z",
})

response = requests.get(
    "https://api.operata.io/v1/data/ccpLogs",
    auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
    params={"criteria": criteria},
)
response.raise_for_status()
entries = response.json()

Errors

Status	Code	When	Recover
400	`invalid_request`	`criteria` is missing, not valid JSON, or references unknown fields.	Confirm the JSON parses and the field names are `agent`, `fromTime`, `toTime`.

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 — fetch the full Operata record for a contact ID surfaced in the logs.
CCP error logs — field reference for CCP error entries.
CCP agent states — agent state values referenced in log entries.
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.

Query Parameters

criteria

string<json>

JSON input for agent name & time criteria

Response

200

Get detailed contact stats

Get configured users

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

​Related

Authorizations

Query Parameters

Response

Endpoint

Parameters

Query

Response

Example

Errors

Related