GET Stats / Time in App

Time in app sessions are returned as a feed of DateTime objects with counts next to them. These timestamps represent the beginning of an hour period, and the count is the number of sessions that happened in that hour.

Endpoint URL: https://api.carnivalmobile.com/v6/stats/sessions

Parameters

Examples

# Default parameters (Last Month)
curl -X GET -i -u :$API_KEY -H 'Accept: application/json' https://api.carnivalmobile.com/v6/stats/sessions

# With Parameters for To and From
curl -XGET -i -u :$API_KEY -H 'Accept: application/json' https://api.carnivalmobile.com/v6/stats/sessions?from=2018-07-25&to=2018-07-28

Result Format

[
  {
    "date": "2015-07-25T00:00:00.000Z",
    "count": 23543
  },
  {
    "date": "2015-07-26T00:00:00.000Z",
    "count": 66435
  },
  {
    "date": "2015-07-27T00:00:00.000Z",
    "count": 23542
  },
  {
    "date": "2015-07-28T00:00:00.000Z",
    "count": 35457
  }
]

{
  "error":"unauthorized"}

{
  "error":"your api client does not have the correct roles"}

Date Format

This API endpoint uses the ISO 8601 DateTime format. Examples:

• 2015-07-25 (Just date)
• 2015-07-25T00:00:00.000+00:00 (Date, Time, Offset)

Note: When running the curl command with parameters, you should wrap the URL in double quotation mark.