Trip History

Get Vehicle's Summary Trip History

Query Parameters

vehicleId number
driverId number
startDate date-time

Format ISO (2000-12-31T00:00:00.000Z) in UTC Timezone

endDate date-time

Format ISO (2000-12-31T00:00:00.000Z) in UTC Timezone

Responses

• 200
• 400
• 401

---

Success

application/json

Schema

Example (from schema)

Data Exist

Data Empty

---

Schema

message string required
data object[]
Array [
totalTrip number required
totalMovingTripDistance number required
totalAssistedTripDistance number required
totalHourStart string required
totalMovingTripDuration string required
totalAssistedTripDuration string required
totalHourStop string required
summaryTrips object[]
Array [
startTime string required
stopTime string required
vehicleId number required
tripMileage number required
startLong number required
startLat number required
stopLong number required
stopLat number required
maxSpeed number required
type string required
driver object
fullName string required
driverId number required
totalHourStart string required
totalHourStop string required
]
]

{
  "message": "string",
  "data": [
    {
      "totalTrip": 0,
      "totalMovingTripDistance": 0,
      "totalAssistedTripDistance": 0,
      "totalHourStart": "string",
      "totalMovingTripDuration": "string",
      "totalAssistedTripDuration": "string",
      "totalHourStop": "string",
      "summaryTrips": [
        {
          "startTime": "string",
          "stopTime": "string",
          "vehicleId": 0,
          "tripMileage": 0,
          "startLong": 0,
          "startLat": 0,
          "stopLong": 0,
          "stopLat": 0,
          "maxSpeed": 0,
          "type": "string",
          "driver": {
            "fullName": "string"
          },
          "driverId": 0,
          "totalHourStart": "string",
          "totalHourStop": "string"
        }
      ]
    }
  ]
}

{
  "message": "Success",
  "data": {
    "totalTrip": 8.2,
    "totalMovingTripDistance": 8.2,
    "totalAssistedTripDistance": 0,
    "totalHourStart": "00:42:17",
    "totalMovingTripDuration": "00:42:17",
    "totalAssistedTripDuration": "00:00:00",
    "totalHourStop": "288:17:42",
    "summaryTrips": [
      {
        "startTime": "2023-02-27T09:55:10.000Z",
        "stopTime": "2023-02-27T09:57:50.000Z",
        "vehicleId": 12345,
        "tripMileage": 1.03,
        "startLong": 112.7451766,
        "startLat": -7.272995,
        "stopLong": 112.7504116,
        "stopLat": -7.268985,
        "maxSpeed": 49,
        "type": "M",
        "driver": null,
        "driverId": 1,
        "totalHourStart": "00:02:40",
        "totalHourStop": "00:07:27"
      }
    ]
  }
}

{
  "message": "Success",
  "data": {
    "totalTrip": 0,
    "totalMovingTripDistance": 0,
    "totalAssistedTripDistance": 0,
    "totalHourStart": "00:00:00",
    "totalMovingTripDuration": "00:00:00",
    "totalAssistedTripDuration": "00:00:00",
    "totalHourStop": "00:00:00",
    "summaryTrips": []
  }
}

Bad Request

application/json

Schema

Example (from schema)

Expired Token

Bad Token

---

Schema

code string
message string
detail string

{
  "code": "string",
  "message": "string",
  "detail": "string"
}

{
  "code": "E-V1/1-03",
  "message": "An error occurred while executing query",
  "detail": "Context creation failed: jwt expired"
}

{
  "code": "E-V1/1-03",
  "message": "An error occurred while executing query",
  "detail": "Context creation failed: jwt malformed"
}

Unauthorized Request

application/json

Schema

Example (from schema)

Example

---

Schema

code string
message string

{
  "code": "string",
  "message": "string"
}

{
  "code": "E-G1/1-01",
  "message": "Authentication token is required"
}

GET /trips

Authorization

name: bearerAuthtype: httpscheme: bearerbearerFormat: JWT

Request

Base URL

https://vsms-v2-public.mceasy.com/v1

Bearer Token

vehicleId — query

driverId — query

startDate — query

endDate — query

curl / cURL

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

python / requests

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

go / native

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

nodejs / axios

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

ruby / Net::HTTP

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

csharp / RestSharp

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

php / cURL

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

java / OkHttp

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

powershell / RestMethod

curl -L -X GET 'https://vsms-v2-public.mceasy.com/v1/trips' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'