Devices

Retrieves a summary of devices.

get

Provides a high-level overview of devices for the current brand, including total devices and aggregated statistics.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

Auth-Key is required to authenticate the request. If missing, the server will return 401 Unauthorized.

Example: YOUR_AUTH_KEY

Responses

200

The request was successful.

application/json

This provides interfaces for API responses with data.

successbooleanRead-onlyRequired

This is the flag to indicate whether the API call is successful or not.

statusCodeinteger · int32Read-onlyRequired

This is the HTTP status code. This is used to determine the status code to be returned to the client.

messagestring · min: 1Read-onlyRequired

This is the message to be displayed to the user.

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

get

/api/v1/analytics/devices/summary

HTTPcURLJavaScriptPython

GET /api/v1/analytics/devices/summary HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Accept: */*

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "totalDevices": 9999,
    "newDevicesToday": 399,
    "newDevicesThisWeek": 799,
    "newDevicesThisMonth": 899,
    "mobileAppDevices": 0,
    "desktopDevices": 0,
    "androidDevices": 0,
    "iosDevices": 0,
    "windowsDevices": 0,
    "macDevices": 0
  },
  "errors": []
}

Retrieves daily device analytics.

get

Returns the number of active devices within the specified date range. If no dates are provided, defaults to the current period.

Query parameters

startDatestringOptional

The start date (yyyy-MM-dd). Optional.

endDatestringOptional

The end date (yyyy-MM-dd). Optional.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

Auth-Key is required to authenticate the request. If missing, the server will return 401 Unauthorized.

Example: YOUR_AUTH_KEY

Responses

200

The request was successful.

application/json

This provides interfaces for API responses with data.

successbooleanRead-onlyRequired

This is the flag to indicate whether the API call is successful or not.

statusCodeinteger · int32Read-onlyRequired

This is the HTTP status code. This is used to determine the status code to be returned to the client.

messagestring · min: 1Read-onlyRequired

This is the message to be displayed to the user.

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

get

/api/v1/analytics/devices/daily

HTTPcURLJavaScriptPython

GET /api/v1/analytics/devices/daily HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Accept: */*

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "date": "2025-09-09",
    "newDevices": 100,
    "totalDevices": 9999
  },
  "errors": []
}