usage
Get sessions usage for a project with time range and period aggregation, when endDate is 0 or unspecified the current time is implied
get/v1/projects/{projectOrProductUID}/usage/sessions
Path parameters
projectOrProductUIDstring required
Query parameters
startDateinteger
Start date for filtering results, specified as a Unix timestamp
endDateinteger
End date for filtering results, specified as a Unix timestamp
deviceUIDstring[]
A Device UID.
fleetUIDstring[]
Filter by Fleet UID
limitinteger
Limit the number of data points returned
period'day' | 'week' | 'month' required
Period type for aggregation
aggregate'device' | 'fleet' | 'project'
Aggregation level for results
skipRecentDataboolean
When true, skips fetching recent data from raw event tables and only returns data from summary tables. Use this for better performance on large projects.
Response
Response body for Session Usage
Example response
{
"sessions": [
{
"device": "dev:123456789012345",
"first_sync_sessions": 2,
"fleet": "fleet:1042ddc5-3b2c-4cec-b1fb-d3040538094d",
"period": "2025-07-23T00:00:00Z",
"sessions": 12,
"sessions_by_transport": {
"cell": 8,
"ntn": 1,
"wifi": 3
},
"tls_sessions": 3,
"total_bytes": 1048576,
"total_devices": 1
}
]
}