Quickstart

​

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

{
  "data": [
    {
      "id": "ctr_0HXYZ123456789ABCDE",
      "started_at": "2026-05-17T15:02:11Z",
      "duration_ms": 184200,
      "agent": { "id": "agent_42", "name": "Riley Chen" },
      "queue": "billing-tier-1"
    }
  ],
  "next_cursor": null
}

​

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 Contact summary.
• The response uses Operata’s standard paginated envelope: a data array and a next_cursor field that is null when there are no further pages. See Pagination.
• A 429 response means you hit the per-token budget — back off using Retry-After. See Rate limits.
• Every 4xx and 5xx response carries a stable error.code you match on. See Errors.

​

Related