Admin | Consolidated Scorings and Statistics

Get a Company/Application/Group statistics and scorings for period.
Swagger: Scorings and Statistics API
Consolidated Scorings and Statistics — methods that allow to get Scorings and Statistics when authorized as Admin via API Authorization Credentials only!
Please, read this doc carefully before start:
API Authorization
/user-statistics-and-analytics/authentication
Consolidated Scorings
How the aggregated 14-day scoring is counted:
Risk driving Scoring
/product-description/scoring/riskdrivingscore
get
Consolidated Scoring
https://api.telematicssdk.com/statistics/v1/Scorings/consolidated/
Get Company/App/Group average scorings for period

Authorization: Required as Admin via API Authorization credentials
Request
Response
Request
Headers
Authorization
required
string
"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login


Query Parameters
startDate
required
string
2020-09-16
endDate
required
string
2020-09-30
deviceToken
optional
string
One of these is required | GUID - user's deviceToken
CompanyID
optional
string
One of these is required
ApplicationID
optional
string
One of these is required
InstanceID
optional
string
One of these is required
tag
optional
string
consider only tagged trips (follow to SDK features => tags)
Response
200: OK
{
  "Result": {
    "DeviceToken": null,
    "InstanceId": null,
    "AppId": null,
    "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "AccelerationScore": 66.67073736280723,
    "BrakingScore": 69.54081001700418,
    "SpeedingScore": 91.83096305456795,
    "DistractedScore": 81.31542742309476,
    "CorneringScore": 85.3753284897202,
    "OverallScore": 84.23164322151801
  },
  "Status": 200,
  "Title": "",
  "Errors": []
}
get
Consolidated Daily Scoring
https://api.telematicssdk.com/statistics/v1/Scorings/consolidated/daily
Get Company/App/Group daily scorings for period

Authorization: Required as Admin via API authorization credentials
Request
Response
Request
Headers
Authorization
required
string
"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login
Query Parameters
startDate
required
string
2020-09-16
endDate
required
string
2020-09-30
deviceToken
optional
string
One of these is required
CompanyID
optional
string
One of these is required
ApplicationID
optional
string
One of these is required
InstanceID
optional
string
One of these is required
tag
optional
string
consider only tagged trips (follow to SDK Feature => tags)
Response
200: OK
{
  "Result": [
    {
      "DeviceToken": null,
      "InstanceId": null,
      "AppId": null,
      "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "AccelerationScore": 66.71781033153431,
      "BrakingScore": 69.6515034695451,
      "SpeedingScore": 91.87818041634542,
      "DistractedScore": 81.51195065535852,
      "CorneringScore": 85.46877409406322,
      "OverallScore": 84.25751734772552,
      "ReportDate": "2020-09-02T00:00:00"
    },
    {
      "DeviceToken": null,
      "InstanceId": null,
      "AppId": null,
      "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "AccelerationScore": 66.70100697134005,
      "BrakingScore": 69.56312935708753,
      "SpeedingScore": 91.83733539891557,
      "DistractedScore": 81.44848954298993,
      "CorneringScore": 85.30286599535243,
      "OverallScore": 84.15646785437646,
      "ReportDate": "2020-09-01T00:00:00"
    },
    {
      "DeviceToken": null,
      "InstanceId": null,
      "AppId": null,
      "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "AccelerationScore": 66.76086956521739,
      "BrakingScore": 69.43167701863354,
      "SpeedingScore": 91.8975155279503,
      "DistractedScore": 81.43711180124224,
      "CorneringScore": 85.4417701863354,
      "OverallScore": 84.17468944099379,
      "ReportDate": "2020-09-03T00:00:00"
    }
  ],
  "Status": 200,
  "Title": "",
  "Errors": []
}
Consolidated Users' Statistics
get
Consolidated Users' Statistics
https://api.telematicssdk.com/statistics/v1/Statistics/consolidated/
Get Company/App/Group average statistics for period

Authorization: Required as Admin via API Authorization Credentials
Request
Response
Request
Headers
Authorization
required
string
"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login
Query Parameters
startDate
required
string
2020-09-16
endDate
required
string
2020-09-30
deviceToken
optional
string
One of these is required
CompanyID
optional
string
One of these is required
ApplicationID
optional
string
One of these is required
InstanceID
optional
string
One of these is required
tag
optional
string
Consider only tagged trips (follow to SDK Features => Tags)
Response
200: OK
{
  "Result": {
    "DeviceToken": null,
    "InstanceId": null,
    "AppId": null,
    "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "TotalRegisteredUsers": 190,
    "ActiveUsers": 1313,
    "MileageKm": 537617.7080000002,
    "MileageMile": 334075.64375119965,
    "TripsCount": 45296,
    "DriverTripsCount": 0,
    "OtherTripsCount": 45296,
    "MaxSpeedKmh": 397713952,
    "MaxSpeedMileh": 247139449.77279997,
    "AverageSpeedKmh": 57.81757677554955,
    "AverageSpeedMileh": 35.92784220832652,
    "TotalSpeedingKm": 89678.98899999993,
    "TotalSpeedingMile": 55726.523764600104,
    "AccelerationCount": 19714,
    "BreakingCount": 33247,
    "CorneringCount": 14506,
    "PhoneUsageDurationMin": 20072.68333333334,
    "PhoneUsageDistanceKm": 14837.512000000017,
    "PhoneUsageDistanceMile": 9220.029956800094,
    "PhoneUsageOverSpeedDurationMin": 160.76666666666662,
    "PhoneUsageOverSpeedDistanceKm": 208.73200000000003,
    "PhoneUsageOverSpeedDistanceMile": 129.7060647999999,
    "DrivingTime": 829817.2833333338,
    "NightDrivingTime": 49086.56666017324,
    "DayDrivingTime": 540299.1333711203,
    "RushHoursDrivingTime": 279793.433260154
  },
  "Status": 200,
  "Title": "",
  "Errors": []
}
get
Consolidated Daily Users' Statistics
https://api.telematicssdk.com/statistics/v1/Statistics/consolidated/daily/
Get Company/App/Group daily statistics for period
Request
Response
Request
Headers
Authorization
required
string
"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login
Query Parameters
startDate
required
string
2020-09-16
endDate
required
string
2020-09-30
deviceToken
optional
string
One of these is required
CompanyID
optional
string
One of these is required
ApplicationID
optional
string
One of these is required
InstanceID
optional
string
One of these is required
tag
optional
string
Consider only tagged tracks (Follow to SDK Features => tags)
Response
200: OK
{
  "Result": [
    {
      "DeviceToken": null,
      "InstanceId": null,
      "AppId": null,
      "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "ReportDate": "2020-09-01T00:00:00",
      "TotalRegisteredUsers": 46,
      "ActiveUsers": 905,
      "MileageKm": 50653.07400000001,
      "MileageMile": 31475.820183600037,
      "TripsCount": 4341,
      "DriverTripsCount": 0,
      "OtherTripsCount": 4341,
      "MaxSpeedKmh": 216.9322509765625,
      "MaxSpeedMileh": 134.8017007568359,
      "AverageSpeedKmh": 44.83533361466009,
      "AverageSpeedMileh": 27.860676308149806,
      "TotalSpeedingKm": 7804.05500000001,
      "TotalSpeedingMile": 4849.439777000005,
      "AccelerationCount": 1880,
      "BreakingCount": 3045,
      "CorneringCount": 1314,
      "PhoneUsageDurationMin": 1851.566666666664,
      "PhoneUsageDistanceKm": 1328.7619999999986,
      "PhoneUsageDistanceMile": 825.6927067999976,
      "PhoneUsageOverSpeedDurationMin": 16.433333333333337,
      "PhoneUsageOverSpeedDistanceKm": 19.207999999999995,
      "PhoneUsageOverSpeedDistanceMile": 11.935851199999997,
      "DrivingTime": 78763.21666666667,
      "NightDrivingTime": 4070.6166611760855,
      "DayDrivingTime": 51999.18331839889,
      "RushHoursDrivingTime": 26545.38333223015
    },
    {
      "DeviceToken": null,
      "InstanceId": null,
      "AppId": null,
      "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "ReportDate": "2020-09-02T00:00:00",
      "TotalRegisteredUsers": 46,
      "ActiveUsers": 908,
      "MileageKm": 53735.65699999998,
      "MileageMile": 33391.33725980001,
      "TripsCount": 4503,
      "DriverTripsCount": 0,
      "OtherTripsCount": 4503,
      "MaxSpeedKmh": 233.43724060058594,
      "MaxSpeedMileh": 145.05790130920408,
      "AverageSpeedKmh": 44.997036431821094,
      "AverageSpeedMileh": 27.961158438733623,
      "TotalSpeedingKm": 9048.949999999993,
      "TotalSpeedingMile": 5623.0175300000255,
      "AccelerationCount": 1951,
      "BreakingCount": 3173,
      "CorneringCount": 1495,
      "PhoneUsageDurationMin": 1927.449999999997,
      "PhoneUsageDistanceKm": 1414.5970000000002,
      "PhoneUsageDistanceMile": 879.0305757999977,
      "PhoneUsageOverSpeedDurationMin": 15.816666666666672,
      "PhoneUsageOverSpeedDistanceKm": 16.258999999999997,
      "PhoneUsageOverSpeedDistanceMile": 10.1033426,
      "DrivingTime": 82229.74999999991,
      "NightDrivingTime": 4256.0333348587155,
      "DayDrivingTime": 53537.23337029666,
      "RushHoursDrivingTime": 28486.74998111278
    },
    {
      "DeviceToken": null,
      "InstanceId": null,
      "AppId": null,
      "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "ReportDate": "2020-09-03T00:00:00",
      "TotalRegisteredUsers": 46,
      "ActiveUsers": 917,
      "MileageKm": 52622.850000000064,
      "MileageMile": 32699.838990000066,
      "TripsCount": 4606,
      "DriverTripsCount": 0,
      "OtherTripsCount": 4606,
      "MaxSpeedKmh": 349.6319885253906,
      "MaxSpeedMileh": 217.2613176696777,
      "AverageSpeedKmh": 44.543960321550294,
      "AverageSpeedMileh": 27.679616943811364,
      "TotalSpeedingKm": 8844.20399999999,
      "TotalSpeedingMile": 5495.788365600025,
      "AccelerationCount": 1932,
      "BreakingCount": 3282,
      "CorneringCount": 1383,
      "PhoneUsageDurationMin": 2028.9833333333297,
      "PhoneUsageDistanceKm": 1488.9430000000004,
      "PhoneUsageDistanceMile": 925.2291801999974,
      "PhoneUsageOverSpeedDurationMin": 19.3,
      "PhoneUsageOverSpeedDistanceKm": 28.545999999999996,
      "PhoneUsageOverSpeedDistanceMile": 17.73848439999999,
      "DrivingTime": 82253.96666666663,
      "NightDrivingTime": 4572.133339047432,
      "DayDrivingTime": 52195.133328177035,
      "RushHoursDrivingTime": 29530.79998118058
    }
  ],
  "Status": 200,
  "Title": "",
  "Errors": []
}
Admin | User(s) - Scorings and Statistics
Next - Step 4: API | User Statistics, Scores, Trips
Trips API
Last updated 6 months ago
Admin | Consolidated Scorings and Statistics

Consolidated Scorings

getConsolidated Scoring

getConsolidated Daily Scoring

Consolidated Users' Statistics

getConsolidated Users' Statistics

getConsolidated Daily Users' Statistics

get
Consolidated Scoring

get
Consolidated Daily Scoring

get
Consolidated Users' Statistics

get
Consolidated Daily Users' Statistics
