Active Devices

The active devices API provides analytics on unique device engagement and user activity patterns across your application. This suite enables multi-dimensional analysis of active device counts with customizable grouping by device type, platform, bundle, date, app version, and country.

Download Active Devices OpenAPI Document

End Points

GET

/activedevice/multigroup

Get active devices count by group

The get active devices count by group API provides flexible active devices analytics with customizable grouping and aggregation capabilities.
This endpoint allows you to analyze active devices data across multiple dimensions simultaneously, creating hierarchical breakdowns of active devices counts based on specified grouping criteria. The API requires a date range and grouping configuration, with optional filtering by platform.
The unique grouping system enables multi-dimensional analysis by combining up to three grouping entities such as device type, platform, bundle, date, app version and country. The response structure dynamically adapts to match your grouping configuration, creating nested JSON hierarchies that reflect the specified group order. For example, grouping by "platform,country,devicetype" returns data organized first by platform, then by country within each platform, and finally by device type within each country. This flexible structure supports complex analytical queries and enables detailed segmentation analysis.
OAuth Scope : JProxy.jmobileapi.ALL

Query Parameters

startdate

string

(Required)

Beginning of date range for data retrieval, required format - dd-MM-yyyy

enddate

string

(Required)

End of date range for data retrieval, required format - dd-MM-yyy

group

string

(Required)

Comma-separated list of grouping entities (devicetype, platform, bundle, date, appversion, country, event). Maximum 3 groups. Response structure follows the specified group order in nested JSON format.

platform

string

Platform to filter Active Devices (iOS, Android, Windows, tvOS, watchOS, macOS). Default - all platforms.

limit

string

Number of results per page. Default and maximum: 500. Use smaller values to limit response size.

offset

string

Starting position for result pagination (default - 0). Increment by limit value for next page (e.g., 501, 1001).

curl --request GET \
  --url 'https://apptics.zoho.com/cx/api/v1/activedevice/multigroup?startdate=02-08-2025&enddate=24-08-2025&group=platform%2Cdevicetype' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'projectid: 12345689' \
  --header 'zsoid: 10234695'

{
    "result": {
        "iOS": {
            "iPhone": 155248,
            "iPad": 3496
        },
        "Android": {
            "Phone": 40011,
            "Tablet": 1110,
            "Foldables": 1186
        }
    },
    "status": "success"
}