Analytics Portal

Analytics REST API Versioning

Current API version is: v1

The demanded version will be provided in path parameter like below:

/api/v1/oauth/

/api/v1/daily/

If the version requested in the path does not exist, the API will respond with

“HTTP 404 Not Found” error code.

HTTP Status Codes

The Analytics API attemps to return appropriate HTTP status codes for every request.

Code Text Description
200 OK Success!
400 Bad Request The request was invalid or cannot be otherwise served. An accompanying error message will explain further.
401 Unauthorized Missing or incorrect authentication credentials.
403 Forbidden The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why.
404 Not Found The URI requested is invalid or the resource requested, such as an application, does not exists. Also returned when the requested format is not supported by the requested method or the requested API version does not exist.
410 Gone This resource is gone. Used to indicate that an API endpoint has been turned off.
422 Unprocessable Entity Unsupported combination of parameters
429 Too Many Requests Returned in when a request cannot be served due to the application’s rate limit having been exhausted for the resource. See Rate Limiting.
500 Internal Server Error Something is broken. Contact the site administrator providing the error id. The error message body contains error code to find the exception stack trace in the logs.

Error Codes

Analytics REST API will use HTTP response error codes together with API specific error messages in response body:

GET https://analytics.blackberry.com/api/daily/locale?startDate=2016-01-25&endDate=2017-03-26

400 Bad Request

{
  "errors":
  [
    {
      "message":"Time range exceeds maximum limit of 365 days",
      "code":12
    }
  ]
}

500 Internal Server Error

{
  "code":500,
  "message":"There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Code Text Description
01 Invalid JWT token The JWT token used in the request is incorrect
02 Invalid access token The access token used in the request is incorrect
03 Expired JWT token The JWT token used in the request has expired.
04 Expired access token The access token used in the request has expired.
10 Invalid parameter Corresponds with HTTP 400 - parameter was passed with wrong format.
12 Invalid date range Corresponds with HTTP 400 - invalid date range was provided.
13 Version not Acceptable Version requested in the Accept header does not exist
22 Unsupported parameters Unsupported combination of parameters
23 Unsupported query parameter Parameter ‘<PARAMETER_NAME>’ not supported for this endpoint
33 Organization ID invalid Corresponds with HTTP 404 - no enterprise data found for organization ID associated with request
34 Entity does not exist Corresponds with HTTP 404 - the specified resource was not found e.g. /applicationVersion?startDate=2017-01-25&endDate=2017-01-26&appName=non_existent application non_existent does not exist
88 Rate limit exceeded The request limit for this resource has been reached for the current rate limit window.
215 Bad authentication data Typically sent with responses with HTTP code 401. Authentication data provided was invalid.
216 No admin roles Typically sent with responses with HTTP code 403. Resource is not allowed to display without admin role

API Rate limits

Rate limiting of the API is done per user access token.

Rate limits are divided into 15 minute intervals.

There is one bucket available for all GET requests: 1000 calls every 15 minutes.

HTTP response headers enable the client to understand where the client is at for a given rate limit, on the method that was just utilized.

HTTP Header Description
X-RateLimit-Limit the rate limit ceiling for that given endpoint
X-RateLimit-Remaining the number of requests left for the 15 minute window
X-Rate-Limit-Reset the remaining window before the rate limit resets, in UTC epoch miliseconds

When an application exceeds the rate limit for a given API endpoint, the API will return a HTTP 429 “Too Many Requests” response code, and error will be returned in the response body:

{ 
    "errors": 
    [ 
        { 
            "code": 88, 
            "message": "Rate limit exceeded" 
        } 
    ] 
}

REST API Authorization

API client needs to present a JWT token in the request Authorization header.

You can get JWT token using OAuth 2.0

GET /api/{version}/auth/oauth{?accessToken}

REST API requests must be authenticated with JWT token

If a client issues a request without the Authorization header, the API will respond with 401 Unauthorized and the body of the error response will contain an URL the client may use to obtain an OAuth token:

{
    "errors":[
        {
            "message":"Bad authentication data",
            "oAuthUrl":"https://analytics.blackberry.com/api/v1/auth/oauth",
            "code":215
        }
    ]
}

To construct a normal API request, include an Authorization header with the value of

Example request:

GET /api/daily?startDate=2017-01-01&endDate=2017-01-01

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
               eyJpc3MiOiJ0b3B0YWwuY29tIiwiZXhwIjoxNDI2NDIwODAwLCJodHRwOi8vdG9wdGFsLmNvbS9qd3RfY2xhaW1zL2lzX2FkbWluIjp0cnVlLCJjb21wYW55IjoiVG9wdGFsIiwiYXdlc29tZSI6dHJ1ZX0.
               yRQYnWzskCZUxPwaQupWkiUzKELZ49eM7oWxAQK_ZXw

Using an incorrect or revoked bearer token to make API requests will result in:

401 Unauthorized

{
    "errors": [
        {
            "message":"Invalid JWT token",
            "code":1
        }
    ]
}

or

{
    "errors": [
        {
            "message":"Expired JWT token",
            "code":3
        }
    ]
}

oAuth example flow


Request GET /api/v1/daily

Response 401

Body:

{
    "errors": [
        {
            "message":"Bad authentication data",
            "oAuthUrl":"https://analytics.blackberry.com/api/v1/auth/oauth",
            "code":215
        }
    ]
}

Request POST https://oauth_server/sso/oauth2/access_token

Body:

Response 200

Body:

{
    "scope":"com.good.oauth2.client.general goodCurUserLevel goodOrgID goodOrgRole goodOrgType inetUserStatus mail o",
    "expires_in":599,
    "token_type":"Bearer",
    "refresh_token":"77aa8eb9-280b-4ef2-a042-1d8964967a7d",
    "access_token":"83587653-e83e-419b-9281-6467a2761480"
}

Request GET /api/v1/auth/oauth?accessToken=f9063e26-3a29-41ec-86de-1d0d68aa85e9

Response 200

Body:

{
    "JWTToken" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9. eyJpc3MiOiJ0b3B0YWwuY29tIiwiZXhwIjoxNDI2NDIwODAwLCJodHRwOi8vdG9wdGFsLmNvbS9qd3RfY2xhaW1zL2lzX2FkbWluIjp0cnVlLCJjb21wYW55IjoiVG9wdGFsIiwiYXdlc29tZSI6dHJ1ZX0. yRQYnWzskCZUxPwaQupWkiUzKELZ49eM7oWxAQK_ZXw"
}

Auth

Authentications methods

Authentication by OAuth

GET https://analytics.blackberry.com/api/v1/auth/oauth?accessToken=f9063e26-3a29-41ec-86de-1d0d68aa85e9
Requestsexample
Headers
Accept: application/json
Responses200401
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
    "JWTToken" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
                  eyJpc3MiOiJ0b3B0YWwuY29tIiwiZXhwIjoxNDI2NDIwODAwLCJodHRwOi8vdG9wdGFsLmNvbS9qd3RfY2xhaW1zL2lzX2FkbWluIjp0cnVlLCJjb21wYW55IjoiVG9wdGFsIiwiYXdlc29tZSI6dHJ1ZX0.
                  RQYnWzskCZUxPwaQupWkiUzKELZ49eM7oWxAQK_ZXw"
}
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Invalid or expired access token",
      "code": 2
    }
  ]
}

Authentication by OAuth
GET/api/{version}/auth/oauth{?accessToken}

Convert oAuth access token to JWT token that will be used in portal

URI Parameters
HideShow
version
string (required) Example: v1

actual version

accessToken
string (required) Example: f9063e26-3a29-41ec-86de-1d0d68aa85e9

oAuth access token


Daily

Daily stats for portal

All stats

GET https://analytics.blackberry.com/api/v1/daily?startDate=2017-01-01&endDate=2017-01-01&operation=AVG&orgId=123624718&appId=com.good.gcs.g3&appVersion=1.0.0
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

All stats
GET/api/{version}/daily{?startDate,endDate,operation,orgId,appId,appVersion}

return data of all applications

Supported combinations

  1. no combined parameters
  2. appId
  3. appId, appVersion
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-01

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

orgId
string (optional) Example: 123624718

organization Id

appId
string (optional) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.0

combined parameter


Stats for application

GET https://analytics.blackberry.com/api/v1/daily/application?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&appId=com.good.gcs.g3
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "appId": "com.good.gcs.g3",
  "stats": [
    {
      "date": "2017-01-01",
      "secondsUsed": 18730800,
      "launchCount": 284280,
      "crashCount": 23340,
      "uniqueActives": 23321
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "appId": {
      "type": "string",
      "description": "application id"
    },
    "stats": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "date in format yyyy-mm-dd"
          },
          "secondsUsed": {
            "type": "number"
          },
          "launchCount": {
            "type": "number"
          },
          "crashCount": {
            "type": "number"
          },
          "uniqueActives": {
            "type": "number"
          }
        },
        "required": [
          "date",
          "secondsUsed",
          "launchCount",
          "crashCount",
          "uniqueActives"
        ]
      }
    }
  },
  "required": [
    "appId"
  ]
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appId": "com.good.gcs.g3",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appId": {
        "type": "string",
        "description": "application id"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appId",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appId": "com.good.gcs.g3",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appId": {
        "type": "string",
        "description": "application id"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appId",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for application
GET/api/{version}/daily/application{?startDate,endDate,operation,tree,orgId,appId}

Supported combinations

  1. no combined parameters
  2. appId
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (optional) Example: com.good.gcs.g3

combined parameter


Stats for application versions

GET https://analytics.blackberry.com/api/v1/daily/application/version?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&appId=com.good.gcs.g3&appVersion=1.0.0
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appVersion": "2.0.1",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "launchCount": 284280,
        "crashCount": 23340,
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "launchCount": {
              "type": "number"
            },
            "crashCount": {
              "type": "number"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "launchCount",
            "crashCount",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "appVersion"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
Body
[
  {
    "appVersion": "2.0.1",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appVersion",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appVersion": "2.0.1",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appVersion",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for application versions
GET/api/{version}/daily/application/version{?startDate,endDate,operation,tree,orgId,appId,appVersion}

Supported combinations

  1. appId
  2. appId, appVersion
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (required) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

Stats for os

GET https://analytics.blackberry.com/api/v1/daily/os?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&osName=Android&appId=com.good.gcs.g3&appVersion=1.0.0
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appVersion": "2.0.1",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "launchCount": 284280,
        "crashCount": 23340,
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "launchCount": {
              "type": "number"
            },
            "crashCount": {
              "type": "number"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "launchCount",
            "crashCount",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "appVersion"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
Body
[
  {
    "appVersion": "2.0.1",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appVersion",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appVersion": "2.0.1",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appVersion",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for os
GET/api/{version}/daily/os{?startDate,endDate,operation,tree,orgId,osName,appId,appVersion}

Supported combinations

  1. no combined parameters
  2. osName
  3. appId
  4. appId, osName
  5. appId, appVersion
  6. appId, appVersion, osName
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (optional) Example: Android

combined parameter

appId
string (optional) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

Stats for os version

GET https://analytics.blackberry.com/api/v1/daily/os/version?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&osName=Android&osVersion=4.4.2&appId=com.good.gcs.g3&appVersion=1.0.0
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osVersion": "4.4.2",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "launchCount": 284280,
        "crashCount": 23340,
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osVersion": {
        "type": "string",
        "description": "os version"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "launchCount": {
              "type": "number"
            },
            "crashCount": {
              "type": "number"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "launchCount",
            "crashCount",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "osVersion"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osVersion": "4.4.2",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osVersion": {
        "type": "string",
        "description": "os version"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "osVersion",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osVersion": "4.4.2",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osVersion": {
        "type": "string",
        "description": "os version"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "osVersion",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for os version
GET/api/{version}/daily/os/version{?startDate,endDate,operation,tree,orgId,osName,osVersion,appId,appVersion}

Supported combinations

  1. osName
  2. osName, osVersion
  3. appId, osName
  4. appId, osName, osVersion
  5. appId, appVersion, osName
  6. appId, appVersion, osName, osVersion
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (required) Example: Android

combined parameter

osVersion
string (optional) Example: 4.4.2

combined parameter

requires:

  • osName
appId
string (optional) Example: com.good.gcs.g3

combined parameter

requires:

  • osName
appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId + appVersion

Stats for locale

GET https://analytics.blackberry.com/api/v1/daily/locale?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&appId=com.good.gcs.g3&locale=EN
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "locale": "EN",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "launchCount": 284280,
        "crashCount": 23340,
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "locale": {
        "type": "string",
        "description": "locale"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "launchCount": {
              "type": "number"
            },
            "crashCount": {
              "type": "number"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "launchCount",
            "crashCount",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "locale"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "locale": "EN",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "locale": {
        "type": "string",
        "description": "locale"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "locale",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "locale": "EN",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "locale": {
        "type": "string",
        "description": "locale"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "locale",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for locale
GET/api/{version}/daily/locale{?startDate,endDate,operation,tree,orgId,appId,locale}

Supported combinations

  1. no combined parameters
  2. locale
  3. appId
  4. appId, locale
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (optional) Example: com.good.gcs.g3

combined parameter

locale
string (optional) Example: EN

combined parameter


Stats for model

GET https://analytics.blackberry.com/api/v1/daily/model?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&osName=Android&appId=com.good.gcs.g3&appVersion=1.0.0&model=SAMSUNG-SM-G930A
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "model": "SAMSUNG-SM-G930A",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "launchCount": 284280,
        "crashCount": 23340,
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "model": {
        "type": "string",
        "description": "model"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "launchCount": {
              "type": "number"
            },
            "crashCount": {
              "type": "number"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "launchCount",
            "crashCount",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "model"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "model": "SAMSUNG-SM-G930A",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "model": {
        "type": "string",
        "description": "model"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "model",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "model": "SAMSUNG-SM-G930A",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "model": {
        "type": "string",
        "description": "model"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "model",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for model
GET/api/{version}/daily/model{?startDate,endDate,operation,tree,orgId,osName,appId,appVersion,model}

Supported combinations

  1. osName
  2. osName, model
  3. appId, appVersion
  4. appId, appVersion, model
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (optional) Example: Android

combined parameter

excludes:

  • appId

  • appId + appVersion

  • appVersion

appId
string (optional) Example: com.good.gcs.g3

combined parameter

requires:

  • appVersion

excludes:

  • osName
appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

excludes:

  • osName
model
string (optional) Example: SAMSUNG-SM-G930A

combined parameter

requires:

  • osName

  • appId + appVersion


Stats for timezone

GET https://analytics.blackberry.com/api/v1/daily/timezone?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&osName=Android&appId=com.good.gcs.g3&timezone=America/Chicago
Requeststree=truetree=falseoperation=SUM
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "timezone": "America/Chicago",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "launchCount": 284280,
        "crashCount": 23340,
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "timezone": {
        "type": "string",
        "description": "timezone"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "launchCount": {
              "type": "number"
            },
            "crashCount": {
              "type": "number"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "launchCount",
            "crashCount",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "timezone"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "timezone": "America/Chicago",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "timezone": {
        "type": "string",
        "description": "timezone"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "timezone",
      "date",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "timezone": "America/Chicago",
    "secondsUsed": 18730800,
    "launchCount": 284280,
    "crashCount": 23340,
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "timezone": {
        "type": "string",
        "description": "timezone"
      },
      "secondsUsed": {
        "type": "number"
      },
      "launchCount": {
        "type": "number"
      },
      "crashCount": {
        "type": "number"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "timezone",
      "secondsUsed",
      "launchCount",
      "crashCount",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for timezone
GET/api/{version}/daily/timezone{?startDate,endDate,operation,tree,orgId,osName,appId,timezone}

Supported combinations

  1. no combined parameters
  2. timezone
  3. osName
  4. osName, timezone
  5. osName, appId
  6. osName, appId, timezone
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (optional) Example: Android

combined parameter

appId
string (optional) Example: com.good.gcs.g3

combined parameter

requires:

  • osName
timezone
string (optional) Example: America/Chicago

combined parameter

requires:

  • osName + osVersion

  • osName + osVersion + appId

  • osName + osVersion + appId + appVersion


Stats for application features

GET https://analytics.blackberry.com/api/v1/daily/feature?startDate=2017-01-01&endDate=2017-01-03&operation=AVG&tree=false&orgId=123624718&appId=com.good.gcs.g3&appVersion=1.0.1&features=CALENDAR,CONTACTS
Requeststree=truetree=falseoperation=SUMoperation=AVG
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "feature": "CALENDAR",
    "stats": [
      {
        "date": "2017-01-01",
        "secondsUsed": 18730800,
        "activeCount": 73,
        "usagePercentage": 63,
        "cumulativeUsagePercentage": 34
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "feature": {
        "type": "string",
        "description": "feature name"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm-dd"
            },
            "secondsUsed": {
              "type": "number"
            },
            "activeCount": {
              "type": "number"
            },
            "usagePercentage": {
              "type": "number"
            },
            "cumulativeUsagePercentage": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "secondsUsed",
            "activeCount",
            "usagePercentage",
            "cumulativeUsagePercentage"
          ]
        }
      }
    },
    "required": [
      "feature"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "feature": "CALENDAR",
    "date": "2017-01-01",
    "secondsUsed": 18730800,
    "activeCount": 73,
    "usagePercentage": 63,
    "cumulativeUsagePercentage": 34
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "feature": {
        "type": "string",
        "description": "feature name"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm-dd"
      },
      "secondsUsed": {
        "type": "number"
      },
      "activeCount": {
        "type": "number"
      },
      "usagePercentage": {
        "type": "number"
      },
      "cumulativeUsagePercentage": {
        "type": "number"
      }
    },
    "required": [
      "feature",
      "date",
      "secondsUsed",
      "activeCount",
      "usagePercentage",
      "cumulativeUsagePercentage"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "featureName": "CALENDAR",
  "secondsUsed": 18730800,
  "activeCount": 244,
  "usagePercentage": 0,
  "cumulativeUsagePercentage": 0
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "featureName": {
      "type": "string",
      "description": "feature name"
    },
    "secondsUsed": {
      "type": "number"
    },
    "activeCount": {
      "type": "number"
    },
    "usagePercentage": {
      "type": "number"
    },
    "cumulativeUsagePercentage": {
      "type": "number"
    }
  },
  "required": [
    "featureName",
    "secondsUsed",
    "activeCount",
    "usagePercentage",
    "cumulativeUsagePercentage"
  ],
  "additionalProperties": false
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "featureName": "CALENDAR",
  "secondsUsed": 18730800,
  "activeCount": 50,
  "usagePercentage": 63,
  "cumulativeUsagePercentage": 34
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "featureName": {
      "type": "string",
      "description": "feature name"
    },
    "secondsUsed": {
      "type": "number"
    },
    "activeCount": {
      "type": "number"
    },
    "usagePercentage": {
      "type": "number"
    },
    "cumulativeUsagePercentage": {
      "type": "number"
    }
  },
  "required": [
    "featureName",
    "secondsUsed",
    "activeCount",
    "usagePercentage",
    "cumulativeUsagePercentage"
  ],
  "additionalProperties": false
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for application features
GET/api/{version}/daily/feature{?startDate,endDate,operation,tree,orgId,appId,appVersion,features}

Supported combinations

  1. appId
  2. appId, appVersion
  3. appId, features
  4. appId, appVersion, features
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

operation
string (optional) Example: AVG

Choices: SUM AVG

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (required) Example: com.good.gcs.g3
appVersion
string (optional) Example: 1.0.1

combined parameter

requires:

  • appId
features
string (optional) Example: CALENDAR,CONTACTS

combined parameter, uses comma as separator for features

requires:

  • appId

Monthly

Monthly stats for portal

Stats for allApps

GET https://analytics.blackberry.com/api/v1/monthly?startDate=2017-01&endDate=2017-02
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for allApps
GET/api/{version}/monthly{?startDate,endDate}

return data of all applications

URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date


Stats for application

GET https://analytics.blackberry.com/api/v1/monthly/application?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&appId=com.good.gcs.g3
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "appId": "com.good.gcs.g3",
  "stats": [
    {
      "date": "2017-01",
      "uniqueActives": 23321
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "appId": {
      "type": "string",
      "description": "application id"
    },
    "stats": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "date in format yyyy-mm"
          },
          "uniqueActives": {
            "type": "number"
          }
        },
        "required": [
          "date",
          "uniqueActives"
        ]
      }
    }
  },
  "required": [
    "appId"
  ]
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appId": "com.good.gcs.g3",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appId": {
        "type": "string",
        "description": "application id"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appId",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for application
GET/api/{version}/monthly/application{?startDate,endDate,tree,orgId,appId}

Supported combinations

  1. no combined parameters
  2. appId
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (optional) Example: com.good.gcs.g3

combined parameter


Stats for application versions

GET https://analytics.blackberry.com/api/v1/monthly/application/version?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&appId=com.good.gcs.g3&appVersion=1.0.0
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appVersion": "2.0.1",
    "stats": [
      {
        "date": "2017-01",
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "appVersion"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appVersion": "2.0.1",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appVersion": {
        "type": "string",
        "description": "application version"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "appVersion",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for application versions
GET/api/{version}/monthly/application/version{?startDate,endDate,tree,orgId,appId,appVersion}

Supported combinations

  1. appId
  2. appId, appVersion
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (required) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

Stats for os

GET https://analytics.blackberry.com/api/v1/monthly/os?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&osName=Android&appId=com.good.gcs.g3&appVersion=1.0.0
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osName": "Android",
    "stats": [
      {
        "date": "2017-01",
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osName": {
        "type": "string",
        "description": "os name"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "osName"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osName": "Android",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osName": {
        "type": "string",
        "description": "os name"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "osName",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for os
GET/api/{version}/monthly/os{?startDate,endDate,tree,orgId,osName,appId,appVersion}

Supported combinations

  1. no combined parameters
  2. osName
  3. appId
  4. appId, osName
  5. appId, appVersion
  6. appId, appVersion, osName
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (required) Example: Android

combined parameter

requires:

  • appId

  • appId + appVersion

appId
string (optional) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

Stats for os version

GET https://analytics.blackberry.com/api/v1/monthly/os/version?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&osName=Android&osVersion=4.4.2&appId=4.4.2&appVersion=4.4.2
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osVersion": "4.4.2",
    "stats": [
      {
        "date": "2017-01",
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osVersion": {
        "type": "string",
        "description": "os version"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "osVersion"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "osVersion": "4.4.2",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osVersion": {
        "type": "string",
        "description": "os version"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "osVersion",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for os version
GET/api/{version}/monthly/os/version{?startDate,endDate,tree,orgId,osName,osVersion,appId,appVersion}

Supported combinations

  1. osName
  2. osName, osVersion
  3. appId, appVersion, osName
  4. appId, appVersion, osName, osVersion
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (required) Example: Android

combined parameter

osVersion
string (optional) Example: 4.4.2

combined parameter

appId
string (optional) Example: 4.4.2

combined parameter

requires:

  • osName + appVersion
appVersion
string (optional) Example: 4.4.2

combined parameter

requires:

  • osName + appId

Stats for locale

GET https://analytics.blackberry.com/api/v1/monthly/locale?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&appId=com.good.gcs.g3&appVersion=4.4.2&osName=Android&locale=EN
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "locale": "EN",
    "stats": [
      {
        "date": "2017-01",
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "locale": {
        "type": "string",
        "description": "locale"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "locale"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "locale": "EN",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "locale": {
        "type": "string",
        "description": "locale"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "locale",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for locale
GET/api/{version}/monthly/locale{?startDate,endDate,tree,orgId,appId,appVersion,osName,locale}

Supported combinations

  1. no combined parameters
  2. locale
  3. osName
  4. osName, locale
  5. appId
  6. appId, locale
  7. appId, appVersion
  8. appId, appVersion, locale
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

appId
string (optional) Example: com.good.gcs.g3

combined parameter

osName
string (optional) Example: Android

combined parameter

appVersion
string (optional) Example: 4.4.2

combined parameter

locale
string (optional) Example: EN

combined parameter


Stats for model

GET https://analytics.blackberry.com/api/v1/monthly/model?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&osName=Android&appId=com.good.gcs.g3&appVersion=1.0.0&model=SAMSUNG-SM-G930A
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "model": "SAMSUNG-SM-G930A",
    "stats": [
      {
        "date": "2017-01",
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "model": {
        "type": "string",
        "description": "model"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "model"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "model": "SAMSUNG-SM-G930A",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "model": {
        "type": "string",
        "description": "model"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "model",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for model
GET/api/{version}/monthly/model{?startDate,endDate,tree,orgId,osName,appId,appVersion,model}

Supported combinations

  1. no combined parameters
  2. osName
  3. osName, model
  4. appId
  5. appId, model
  6. appId, appVersion
  7. appId, appVersion, model
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (optional) Example: Android

combined parameter

excludes:

  • appId

  • appVersion

  • appVersion + appId

appId
string (optional) Example: com.good.gcs.g3

combined parameter

excludes:

  • osName
appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

excludes:

  • osName
model
string (optional) Example: SAMSUNG-SM-G930A

combined parameter

requires:

  • osName

  • appId

  • appId + appVersion


Stats for timezone

GET https://analytics.blackberry.com/api/v1/monthly/timezone?startDate=2017-01&endDate=2017-02&tree=false&orgId=123624718&osName=Android&appId=com.good.gcs.g3&appVersion=1.0.0&timezone=America/Chicago
Requeststree=truetree=false
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "timezone": "America/Chicago",
    "stats": [
      {
        "date": "2017-01",
        "uniqueActives": 23321
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "timezone": {
        "type": "string",
        "description": "timezone"
      },
      "stats": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string",
              "description": "date in format yyyy-mm"
            },
            "uniqueActives": {
              "type": "number"
            }
          },
          "required": [
            "date",
            "uniqueActives"
          ]
        }
      }
    },
    "required": [
      "timezone"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "timezone": "America/Chicago",
    "date": "2017-01",
    "uniqueActives": 23321
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "timezone": {
        "type": "string",
        "description": "timezone"
      },
      "date": {
        "type": "string",
        "description": "date in format yyyy-mm"
      },
      "uniqueActives": {
        "type": "number"
      }
    },
    "required": [
      "timezone",
      "date",
      "uniqueActives"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Stats for timezone
GET/api/{version}/monthly/timezone{?startDate,endDate,tree,orgId,osName,appId,appVersion,timezone}

Supported combinations

  1. no combined parameters
  2. timezone
  3. appId
  4. appId, timezone
  5. appId, appVersion
  6. appId, appVersion, timezone
  7. osName
  8. osName, timezone
  9. osName, appId, appVersion
  10. osName, appId, appVersion, timezone
  11. appId, osName
  12. appId, osName, timezone
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01

Start Date

endDate
string (required) Example: 2017-02

End Date

tree
boolean (optional) Example: false

default false

orgId
string (optional) Example: 123624718

organization Id

osName
string (optional) Example: Android

combined parameter

appId
string (optional) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.0

combined parameter

requires:

  • appId

  • osName + appId

excludes:

  • osName
timezone
string (optional) Example: America/Chicago

combined parameter

requires:

  • appId

  • appId + appVersion

  • osName

  • osName + appId

  • osName + appId + appVersion


Metadata

Metadata for portal

List of All applications

GET https://analytics.blackberry.com/api/v1/applications
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "appId": "com.good.gcs.g3",
    "name": "Good Work",
    "versions": [
      {
        "name": "2.0.1"
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "appId": {
        "type": "string",
        "description": "application id"
      },
      "name": {
        "type": "string",
        "description": "application name"
      },
      "versions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "version name"
            }
          },
          "required": [
            "name"
          ]
        }
      }
    },
    "required": [
      "appId",
      "name"
    ]
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

List of All applications
GET/api/{version}/applications

return all applications

URI Parameters
HideShow
version
string (required) Example: v1

actual version


List of All Os

GET https://analytics.blackberry.com/api/v1/os
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "name": "Android",
  "versions": [
    {
      "name": "2.0.1"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "os name"
    },
    "versions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "version name"
          }
        },
        "required": [
          "name"
        ]
      }
    }
  },
  "required": [
    "name",
    "versions"
  ],
  "additionalProperties": false
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

List of All Os
GET/api/{version}/os

return all os

URI Parameters
HideShow
version
string (required) Example: v1

actual version


List of All Timezone

GET https://analytics.blackberry.com/api/v1/timezone
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "name": "America/Anchorage"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "timezone name"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

List of All Timezone
GET/api/{version}/timezone

return all timezone

URI Parameters
HideShow
version
string (required) Example: v1

actual version


User Profile

GET https://analytics.blackberry.com/api/v1/profile
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
{
  "orgId": 222964041,
  "company": "Fake Company",
  "givenName": "John",
  "country": "US",
  "sn": "Fakeuser",
  "email": "fakeuser@fakecompany.com"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "orgId": {
      "type": "number"
    },
    "company": {
      "type": "string"
    },
    "givenName": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "sn": {
      "type": "string"
    },
    "email": {
      "type": "string"
    }
  },
  "required": [
    "orgId",
    "company",
    "givenName",
    "country",
    "sn",
    "email"
  ],
  "additionalProperties": false
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

User Profile
GET/api/{version}/profile

return user profile

URI Parameters
HideShow
version
string (required) Example: v1

actual version


Meta info statistics

GET https://analytics.blackberry.com/api/v1/metainfo/statistics
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/analytics.v1.0+x-zip-compressed
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "id": 0,
    "description": "The stats for all apps combined for the enterprise"
  }
]
Schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "number",
        "description": "id of table to export"
      },
      "description": {
        "type": "string",
        "description": "description of table to export"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Meta info statistics
GET/api/{version}/metainfo/statistics

List of all statistics that can be exported

URI Parameters
HideShow
version
string (required) Example: v1

actual version


Export statistics

POST https://analytics.blackberry.com/api/v1/export/statistics
Requestsexample
Headers
Accept: application/json
Body
{
  "ids": [
    1
  ],
  "format": "CSV"
}
Schema
{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "id table to export. look at Meta info statistics"
    },
    "format": {
      "enum": [
        "CSV",
        "JSON"
      ],
      "description": "format of exported params"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200400401403404422429500
Headers
Content-Type: application/analytics.v1.0+x-zip-compressed
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Export statistics
POST/api/{version}/export/statistics

Export statistics as text files. You pass id field from Meta info statistics

URI Parameters
HideShow
version
string (required) Example: v1

actual version


Application features ranking

GET https://analytics.blackberry.com/api/v1/feature/ranking?startDate=2017-01-01&endDate=2017-01-03&orgId=123624718&appId=com.good.gcs.g3&appVersion=1.0.1
Requestsexample
Headers
Accept: application/json
Responses200400401403404422429500
Headers
Content-Type: application/analytics.v1.0+x-zip-compressed
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 50
X-Rate-Limit-Reset: 1487857632
Body
[
  {
    "name": "CALENDAR",
    "rank": 1
  }
]
Schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string"
      },
      "rank": {
        "type": "number"
      }
    },
    "required": [
      "name",
      "rank"
    ]
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Invalid date range: 2017-01-25 - 2027-01-26",
      "code": 12
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Bad authentication data. You can login using oauth2 service at <authorization_server_url> ",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Request is forbidden for you",
      "oAuthUrl": "https://oath_server/sso/oauth2/access_token",
      "samlAuthUrl": " https://analytics.blackberry.com/api/auth/v1/oauth",
      "code": 215
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "oAuthUrl": {
            "type": "string",
            "description": "oAuth access url"
          },
          "samlAuthUrl": {
            "type": "string",
            "description": "saml access url"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Application 'non_existent' does not exists",
      "code": 34
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "errors": [
    {
      "message": "Unsupported combination of parameters",
      "code": 23
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-Rate-Limit-Reset: 1487857632
Body
{
  "errors": [
    {
      "message": "Rate limit exceeded",
      "code": 88
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "message for error"
          },
          "code": {
            "type": "number",
            "description": "error number code"
          }
        },
        "required": [
          "message",
          "code"
        ]
      }
    }
  }
}
Headers
Content-Type: application/analytics.v1.0+json
Body
{
  "code": 500,
  "message": "There was an error processing your request. It has been logged (ID eabbf599e5b63e9e)."
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "message for error"
    },
    "code": {
      "type": "number",
      "description": "error number code"
    }
  }
}

Application features ranking
GET/api/{version}/feature/ranking{?startDate,endDate,orgId,appId,appVersion}

Returns list with features and rank for selected application and data range

Supported combinations

  1. appId
  2. appId, appVersion
URI Parameters
HideShow
version
string (required) Example: v1

actual version

startDate
string (required) Example: 2017-01-01

Start Date

endDate
string (required) Example: 2017-01-03

End Date

orgId
string (optional) Example: 123624718

organization Id

appId
string (required) Example: com.good.gcs.g3

combined parameter

appVersion
string (optional) Example: 1.0.1

combined parameter


Generated on 17 Jul 2017