Skip to main content
GET
Break down sessions

Query Parameters

group_by
enum<string>
required

The dimension to group by. browser_label is the browser and major version (for example Chrome 141); city groups pair each city with its country_code.

Available options:
browser,
browser_label,
platform,
verdict,
country,
city,
asn
Example:

"browser"

limit
integer
default:50

The number of groups to return, largest first. Sessions in the remaining groups are counted in other.

Required range: 1 <= x <= 500
Example:

50

verdict
enum<string>

Only sessions whose current verdict is this value.

Available options:
bot,
human,
inconclusive
Example:

"human"

platform
enum<string>
Available options:
ios,
android,
macos,
windows,
linux
Example:

"ios"

browser
enum<string>
Available options:
chrome,
safari,
firefox,
edge,
webview,
arc,
helium
Example:

"chrome"

browser_label
string

Exact browser label, as returned in a browser_label breakdown.

Maximum string length: 200
Example:

"Chrome 141"

country
string

ISO 3166-1 alpha-2 country code of the session's IP address.

Pattern: ^[A-Za-z]{2}$
Example:

"US"

city
string

City of the session's IP address. Combine with country to pick one city of that name.

Maximum string length: 200
Example:

"Austin"

asn
string

Autonomous system number of the session's IP address, with or without the AS prefix.

Pattern: ^(AS|as)?[0-9]{1,10}$
Example:

"AS7922"

client_user_id
string

Only sessions whose client_user_id is exactly this value.

Required string length: 1 - 256
Example:

"user_123"

since
string<date-time>

Only sessions created at or after this time.

Example:

"2026-09-01T00:00:00Z"

until
string<date-time>

Only sessions created before this time.

Example:

"2026-10-01T00:00:00Z"

Response

Session counts per group.

data
object
required
Example:
meta
object
required
Example: