Skip to main content
GET
/
v1
/
sessions
/
stats
cURL
curl --request GET \
  --url https://api.qyl.dev/v1/sessions/stats
{
  "active_sessions": 1,
  "total_sessions": 1,
  "unique_users": 1,
  "avg_duration_ms": 123,
  "sessions_with_errors": 1,
  "sessions_with_genai": 1,
  "bounce_rate": 0.5,
  "by_device_type": [
    {
      "device_type": "desktop",
      "count": 1,
      "percentage": 50
    }
  ],
  "by_country": [
    {
      "country_code": "<string>",
      "country_name": "<string>",
      "count": 1,
      "percentage": 50
    }
  ]
}

Query Parameters

​
startTime
string<date-time>

Start time

​
endTime
string<date-time>

End time

Response

The request has succeeded.

Aggregated session statistics

​
active_sessions
integer<int64>
required

Active sessions count

Required range: x >= 0
​
total_sessions
integer<int64>
required

Total sessions in time range

Required range: x >= 0
​
unique_users
integer<int64>
required

Unique users in time range

Required range: x >= 0
​
avg_duration_ms
number<double>
required

Average session duration in milliseconds

​
sessions_with_errors
integer<int64>
required

Sessions with errors

Required range: x >= 0
​
sessions_with_genai
integer<int64>
required

Sessions with GenAI usage

Required range: x >= 0
​
bounce_rate
number<double>
required

Bounce rate (single-page sessions)

Required range: 0 <= x <= 1
​
by_device_type
object[]

Sessions by device type

​
by_country
object[]

Sessions by country