User | Individual Scorings and Statistics

Get Statistics and Scorings as User personaly

Individual Scorings and Statistics — methods that allow to get Scorings and Statistics when authorized as User only!

Please, read this doc carefully before start:

API Authorization

Individual Scorings

How the aggregated 14-day scoring is counted:

Risk driving ScoringEco Scoring

Individual Safe driving Scoring

GET https://api.telematicssdk.com/statistics/v1/Scorings/individual

Get an individual average scoring for requested period. Authorization: Required as User

Query Parameters

NameTypeDescription

startDate

string

2020-09-16

endDate

string

2020-09-30

tag

string

consider only tagged trips (follow to SDK features => tags)

Headers

NameTypeDescription

Authorization

string

"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login

{
  "Result": 
    {
      "DeviceToken": "3fa85f64-5717-4562-b3fc-2c963f66afa3",
      "InstanceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "AppId": "3511c419-ea19-477d-bff0-980ec9dbb864",
      "CompanyId": "2fd6d2ef-7eb6-4beb-a40e-1f9b53f0e0be",
      "AccelerationScore": 94.66666666666667,
      "BrakingScore": 78.66666666666667,
      "SpeedingScore": 40,
      "DistractedScore": 68.66666666666667,
      "CorneringScore": 100,
      "OverallScore": 69.66666666666667
    }
  ,
  "Status": 200,
  "Title": "",
  "Errors": []
}

Individual Daily Safe driving Scoring

GET https://api.telematicssdk.com/statistics/v1/Scorings/individual/daily

Get an individual daily scoring for requested period Authorization: Required as User

Query Parameters

NameTypeDescription

startDate

string

2020-09-16

endDate

string

2020-09-30

tag

string

consider only tagged trips (follow to SDK features => Tags)

Headers

NameTypeDescription

Authorization

string

"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login

{
  "Result": [
    {
      "DeviceToken": "d71937a5-5f3a-4dc2-b449-e80d241864e4",
      "InstanceId": "3c1c8fd7-4133-404a-82e9-93a015d85362",
      "AppId": "3511c419-ea19-477d-bff0-980ec9dbb864",
      "CompanyId": "2fd6d2ef-7eb6-4beb-a40e-1f9b53f0e0be",
      "AccelerationScore": 57,
      "BrakingScore": 70,
      "SpeedingScore": 61,
      "DistractedScore": 65,
      "CorneringScore": 71,
      "OverallScore": 75,
      "CalcDate": "2020-08-01T00:00:00"
    },
    {
      "DeviceToken": "d71937a5-5f3a-4dc2-b449-e80d241864e4",
      "InstanceId": "3c1c8fd7-4133-404a-82e9-93a015d85362",
      "AppId": "3511c419-ea19-477d-bff0-980ec9dbb864",
      "CompanyId": "2fd6d2ef-7eb6-4beb-a40e-1f9b53f0e0be",
      "AccelerationScore": 61,
      "BrakingScore": 67,
      "SpeedingScore": 59,
      "DistractedScore": 66,
      "CorneringScore": 77,
      "OverallScore": 75,
      "CalcDate": "2020-08-03T00:00:00"
    }
  ],
  "Status": 200,
  "Title": "",
  "Errors": []
}

Individual Eco driving Scoring

GET https://api.telematicssdk.com/statistics/v1/Scorings/individual/eco

Get current accumulated user eco scoring Authorization: Required as User

Headers

NameTypeDescription

Authorization

string

"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login)

{
  "Result": [
    {
      "DeviceToken": "d71937a5-5f3a-4fc2-b449-e80d241864e4",
      "InstanceId": "3c1c8fd7-4133-405a-82e9-93a015d85362",
      "AppId": "3511c419-ea19-477d-baf0-980ec9dbb864",
      "CompanyId": "2fd6d2ef-7eb6-4bgb-a40e-1f9b53f0e0be",
      "EcoScoringFuel": 99.15114,
      "EcoScoringTyres": 83.39971,
      "EcoScoringBrakes": 85.882416,
      "EcoScoringDepreciation": 99.0,
      "EcoScoring": 82.95479
    }
  ],
  "Status": 200,
  "Title": "",
  "Errors": []
}

Individual Statistics

Individual User Statistics

GET https://api.telematicssdk.com/statistics/v1/Statistics/individual/

Get individual user statistics for requested period Authorization: Required as User

Query Parameters

NameTypeDescription

startDate

string

2020-09-16

endDate

string

2020-09-30

tag

string

consider only tagged trips (follow to SDK features => Tags)

Headers

NameTypeDescription

Authorization

string

"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/Auth/Login)

{
  "Result":
    {
      "DeviceToken": "d71937a5-5f3a-4dc2-b449-e80d241864e4",
      "InstanceId": "3c1c8fd7-4133-404a-82e9-93a015d85362",
      "AppId": "3511c419-ea19-477d-bff0-980ec9dbb864",
      "CompanyId": "2fd6d2ef-7eb6-4beb-a40e-1f9b53f0e0be",
      "MileageKm": 50.95000000000001,
      "MileageMile": 31.66033,
      "TripsCount": 9,
      "DriverTripsCount": 0,
      "OtherTripsCount": 9,
      "MaxSpeedKmh": 88.07221984863281,
      "MaxSpeedMileh": 54.728077413940426,
      "AverageSpeedKmh": 29.905130922862075,
      "AverageSpeedMileh": 18.58304835546649,
      "TotalSpeedingKm": 12.16,
      "TotalSpeedingMile": 7.556223999999999,
      "AccelerationCount": 1,
      "BreakingCount": 1,
      "CorneringCount": 1,
      "PhoneUsageDurationMin": 2.5,
      "PhoneUsageDistanceKm": 1.6570000000000003,
      "PhoneUsageDistanceMile": 1.0296598000000001,
      "PhoneUsageOverSpeedDurationMin": 0.05,
      "PhoneUsageOverSpeedDistanceKm": 0.047,
      "PhoneUsageOverSpeedDistanceMile": 0.029205799999999997,
      "DrivingTime": 82.20000000000002,
      "NightDrivingTime": 0,
      "DayDrivingTime": 21.583333373069763,
      "RushHoursDrivingTime": 75.533331990242
    }
  ,
  "Status": 200,
  "Title": "",
  "Errors": []
}

Individual User Daily Statistics

GET https://api.telematicssdk.com/statistics/v1/Statistics/individual/daily/

Get individual daily statistics for requested period Authorization: Required as User

Query Parameters

NameTypeDescription

startDate

string

2020-09-16

endDate

string

2020-09-30

Headers

NameTypeDescription

Authorization

string

"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login

{
    "Result":
    {
        "DeviceToken": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "InstanceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "AppId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "CompanyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "ReportDate": "2020-09-01T00:00:00",
        "MileageKm": 173.363,
        "MileageMile": 107.72776819999999,
        "TripsCount": 9,
        "DriverTripsCount": 0,
        "OtherTripsCount": 9,
        "MaxSpeedKmh": 96.83999633789062,
        "MaxSpeedMileh": 60.17637372436523,
        "AverageSpeedKmh": 41.62794511159958,
        "AverageSpeedMileh": 25.867605092347976,
        "TotalSpeedingKm": 3.5650000000000004,
        "TotalSpeedingMile": 2.215291,
        "AccelerationCount": 5,
        "BreakingCount": 10,
        "CorneringCount": 4,
        "PhoneUsageDurationMin": 5.383333333333334,
        "PhoneUsageDistanceKm": 0.651,
        "PhoneUsageDistanceMile": 0.4045314,
        "PhoneUsageOverSpeedDurationMin": 0.0,
        "PhoneUsageOverSpeedDistanceKm": 0.0,
        "PhoneUsageOverSpeedDistanceMile": 0.0,
        "DrivingTime": 332.41666666666663,
        "NightDrivingTime": 0.0,
        "DayDrivingTime": 195.83333539962769,
        "RushHoursDrivingTime": 142.55000114440918
    },
    "Status": 200,
    "Title": "",
    "Errors": []
}

Individual Latest Scoring and Track dates

Individual Latest Scoring and Track dates

GET https://api.telematicssdk.com/statistics/v1/Statistics/individual/latestDates

Authorization: Required as User

Headers

NameTypeDescription

Authorization

string

"Bearer {Token}" - get it via https://user.telematicssdk.com/v1/auth/login

{
  "Result":
  {
    "DeviceToken": "58156858-3629-4931-89d9-0043e5873b91",
    "InstanceId": "5198e42d-3c0b-498e-9316-388fbc5f501d",
    "AppId": "3511c419-ea19-477d-bff0-980ec9dbb864",
    "CompanyId": "2fd6d2ef-7eb6-4beb-a40e-1f9b53f0e0be",
    "LastTrackDate": "2020-08-20T15:00:58.81", // +03:00
    "LastScoringDate": "2020-08-20T00:00:00"
  },
  "Status": 200,
  "Title": "",
  "Errors": []
}

Last updated