Skip to main content
GET

​
Device Analytics

​
Endpoints

  • GET /api/analytics/workspace/devices
  • GET /api/analytics/{linkId}/devices

​
Query parameters

​
days
number
default:"30"
Date window (1..365)
​
start
string
Optional explicit start date
​
end
string
Optional explicit end date
​
timezone
string
Optional timezone used when resolving date boundaries

​
Access and gates

  • Permission: analytics:read
  • Link-level device endpoint requires deviceRouting feature

​
Response model

Workspace endpoint returns:
  • deviceData
  • browserData
  • osData
Plan-aware behavior:
  • Device, browser, and OS objects can be selectively empty on plans that do not include that breakdown type.
Link endpoint returns:
  • devices
  • browsers
  • os
and validates link ownership in workspace scope.

​
Common errors

  • 403: required feature not available
  • 404: link not found (link endpoint)
  • 500: analytics backend/query failure