Quickstart (v1)

​

Before you start

• An Operata account. Your Operata Group ID is the UUID in the console URL.
• An API token generated under Settings → Config → API.

​

Make the request

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=1"

​

What you should see

[
  {
    "softphoneSummary": {
      "contactId": "56f36f8c-463e-44fe-aff7-54ea7533cec1",
      "agentUserName": "agent_42",
      "agentCity": "Melbourne",
      "networkType": "wlan",
      "networkPerformanceMetrics": {
        "jitter": { "min": 1, "avg": 2, "max": 4 },
        "rtt": { "min": 20, "avg": 32, "max": 36 },
        "mos": { "min": 4.41, "avg": 4.42, "max": 4.42 }
      }
    },
    "contactDurationSummary": {
      "contactDurationRoundedMin": 1,
      "contactDurationActualSec": 19
    }
  }
]

​

What the response means

• You authenticated with HTTP Basic — Group ID as username, token as password. See Authentication.
• You requested one contact from a 24-hour window using the contact summary endpoint. See List contact summaries.
• The response is a plain JSON array. The RecordCount response header holds how many contacts match in total, and you page with from and size. See Pagination.
• A 429 response means you hit the per-token budget — back off using Retry-After. See Rate limits.
• Errors come back as an HTTP status code with a short plain-text body. See Errors.

​

Related