{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/activity/list.json","auth":"required","examples":{"codes":[]},"method":"get","params":[{"name":"vehicleName","type":"string","default":"","desc":"Name of the vehicle (Either the vehicle name or the group name is required for the API call)","required":false,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de7"},{"name":"from","type":"string","default":"","desc":"Trip start timestamp in UTC with format mm-dd-yyyy HH:mm:ss","required":true,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de6"},{"name":"to","type":"string","default":"","desc":"Trip end timestamp in UTC with format mm-dd-yyyy HH:mm:ss","required":true,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de5"},{"name":"groupName","type":"string","default":"","desc":"Name of the group (Either the group name or the vehicle name is mandatory)","required":false,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de4"},{"name":"page","type":"int","default":"1","desc":"Page number of the paginated result","required":false,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de3"}],"results":{"codes":[{"status":200,"name":"","code":"{ \n \"activityResponseVO\":{ \n \"code\":200,\n \"message\":\"Success\",\n \"reason\":\"\",\n \"generatedAt\":\"Dec-16-2015, 10:10 PM UTC\",\n \"currentPage\":1,\n \"totalPages\":1,\n \"activityReport\":[ \n { \n \"vehicleName\":\"Nathen's car\",\n \"vehicleId\": \"b0debf38-a8dd-e511-b684-616a28550141\",\n \"groupName\":\"California\",\n \"tsTime\":\"Dec-15-2015, 06:40 PM UTC\",\n \"tsLat\":37.5026018,\n \"tsLon\":-121.9772597,\n \"tsAddress\":\"5788-5894 Auto Mall Parkway, Fremont, CA 94538, USA\",\n \"teTime\":\"Dec-15-2015, 09:40 PM UTC\",\n \"teLat\":37.5026018,\n \"teLon\":-121.9772597,\n \"teAddress\":\"5788-5894 Auto Mall Parkway, Fremont, CA 94538, USA\",\n \"stopTime\":\"11450 mins\",\n \"distanceTravelled\":\"12 Miles\",\n \"tripTime\":\"180 mins\",\n \"idleTime\":\"1110 mins\",\n \"hardBrakingCounts\":100,\n \"hardAccelerationCounts\":140,\n \"overSpeedEvents\":200,\n \"overSpeedDuration\":\"120 mins\",\n \"maxSpeed\":\"93 MPH\",\n \"averageSpeed\":\"43 MPH\",\n \"reserved1\":null,\n \"reserved2\":null,\n \"reserved3\":null,\n \"reserved4\":null\n }\n ]\n }\n}","language":"json"}]},"settings":"559288b86bf22f170075b794"},"next":{"description":"","pages":[]},"title":"Trips","type":"endpoint","slug":"activity","excerpt":"This API provides you with granular information about trips taken by your fleet within the time period that is requested for. A trip in Azuga is defined as an ignition ON - Ignition OFF cycle. A trip response contains summarized information that can pertain to vehicle health, driving behavior, fuel consumption, etc.,","body":"[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Sample Request\",\n \"body\": \"https://api.azuga.com/azuga-ws/v1/activity/list.json?vehicleName=Nathen's car&from=12-15-2015 00:00:00&to=12-15-2015 10:10:59&groupName=California\"\n}\n[/block]\n##API Response explanation\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Field\",\n \"h-1\": \"Description\",\n \"0-0\": \"code\",\n \"1-0\": \"message\",\n \"2-0\": \"generatedAt\",\n \"3-0\": \"reason\",\n \"4-0\": \"currentPage\",\n \"5-0\": \"totalPages\",\n \"0-1\": \"API Status Code\",\n \"1-1\": \"API Message (Success/Failure)\",\n \"2-1\": \"API generation timestamp in UTC\",\n \"3-1\": \"The reason for failure\",\n \"4-1\": \"The current page\",\n \"5-1\": \"The total number of pages in the result\",\n \"6-0\": \"activityReport\",\n \"7-0\": \"vehicleName\",\n \"8-0\": \"groupName\",\n \"9-0\": \"tsTime\",\n \"10-0\": \"tsLat\",\n \"11-0\": \"tsLon\",\n \"6-1\": \"An array of activityreport objects\",\n \"7-1\": \"Name of the vehicle\",\n \"8-1\": \"Name of the group associated with vehicle\",\n \"9-1\": \"Timestamp in UTC when the ignition turned ON\",\n \"10-1\": \"Latitude coordinate of the location where the ignition turned ON\",\n \"11-1\": \"Longitude coordinate of the location where the ignition turned ON\",\n \"12-0\": \"tsAddress\",\n \"13-0\": \"teTime\",\n \"14-0\": \"teLat\",\n \"15-0\": \"teLon\",\n \"16-0\": \"teAddress\",\n \"12-1\": \"Address of the location where the ignition turned ON\",\n \"13-1\": \"Timestamp in UTC when the ignition turned OFF\",\n \"14-1\": \"Latitude coordinate of the location where the ignition turned OFF\",\n \"15-1\": \"Longitude coordinate of the location where the ignition turned OFF\",\n \"16-1\": \"Address of the location where the ignition turned OFF\",\n \"17-1\": \"Time between an Ignition OFF and the next Ignition ON\",\n \"17-0\": \"stopTime\",\n \"18-0\": \"distanceTravelled\",\n \"19-0\": \"tripTime\",\n \"20-0\": \"idleTime\",\n \"18-1\": \"Total distance driven in that trip\",\n \"19-1\": \"Total time between an Ignition ON and Igntion OFF\",\n \"20-1\": \"Time period during which the vehicle was in the idle state\",\n \"21-0\": \"hardBrakingCounts\",\n \"22-0\": \"hardAccelerationCounts\",\n \"23-0\": \"overSpeedEvents\",\n \"24-0\": \"overSpeedDuration\",\n \"21-1\": \"Number of hard breaking incidents. Hard breaking is the change in speed of 13-16 KMPH in one second (as long as the vehicle is already travelling at a speed of 29 KMPH).\",\n \"22-1\": \"Number of sudden acceleration incidents. Sudden acceleration is the change in speed of 13-16 KMPH in one second.\",\n \"23-1\": \"Number of speeding incidents. A speeding incident is counted when the vehicle exceeds the speed limit set in the speeding alert.\",\n \"24-1\": \"Time during which the vehicle traveled at a speed greater than the one set in the speeding alert.\",\n \"25-0\": \"maxSpeed\",\n \"25-1\": \"Maximum speed attained during the trip\",\n \"26-0\": \"averageSpeed\",\n \"26-1\": \"Average speed during the trip\",\n \"30-0\": \"reserved1\",\n \"31-0\": \"reserved2\",\n \"32-0\": \"reserved3\",\n \"33-0\": \"reserved4\",\n \"30-1\": \"Reserved variable for future use\",\n \"31-1\": \"Reserved variable for future use\",\n \"32-1\": \"Reserved variable for future use\",\n \"33-1\": \"Reserved variable for future use\",\n \"27-0\": \"userId\",\n \"27-1\": \"The unique ID of the driver associated with the trip\",\n \"28-0\": \"userName\",\n \"28-1\": \"The name of the driver associated with the trip\",\n \"29-0\": \"occupants\",\n \"29-1\": \"An array of occupants associated with the trip\"\n },\n \"cols\": 2,\n \"rows\": 34\n}\n[/block]","updates":["5f878574c86e160059a5052f"],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5631b5acbddb091700ad5de2","createdAt":"2015-10-29T05:59:08.818Z","editedParams":true,"editedParams2":true,"version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["559286c7c39c4b2d00127a72","55928a98c39c4b2d00127a83","5592bd7b9a68220d00f1c3db","5593dcaf0e82e81700334e25","5594342f0c33bd0d000595a3","563081713998420d00a509e4","5630941c7581b80d00c51c86","56309f4ff1c0580d00fac666","567923b8239fac0d00c7df25","573306dea6a9c40e00e13875","577a288fd051530e00f65563","579af3982b865e17005a4357","57ee06aa1e42900e0014a374","5951f49a63f39000159e7ef1","5951f4c563f39000159e7ef2","598951542a9dfc000fcacd40","5b3375cc98cb500003e4b363","5bbcd4e29667280003084100"],"_id":"559286c6c39c4b2d00127a71","createdAt":"2015-06-30T12:08:38.768Z","project":"55926c913735880d005f7c65","releaseDate":"2015-06-30T12:08:38.768Z","__v":18,"forked_from":"559286b6c39c4b2d00127a6e"},"__v":4,"category":{"sync":{"isSync":false,"url":""},"pages":["5592bda06bf22f170075b858","5593dbb99755e117000fbf3d","5593dc7a0e82e81700334e23","5631abc1fc94aa0d00e9b5e6","5631b5acbddb091700ad5de2","5631be58fc94aa0d00e9b5f5","56dfa9429cd22c0e00cab10c"],"title":"REPORTS","slug":"fleet-web","order":2,"from_sync":false,"reference":true,"_id":"5592bd7b9a68220d00f1c3db","createdAt":"2015-06-30T16:02:03.540Z","version":"559286c6c39c4b2d00127a71","__v":7,"project":"55926c913735880d005f7c65"},"project":"55926c913735880d005f7c65","parentDoc":null,"user":"55926c39cf9cdb2100b57022","githubsync":""}
getTrips
This API provides you with granular information about trips taken by your fleet within the time period that is requested for. A trip in Azuga is defined as an ignition ON - Ignition OFF cycle. A trip response contains summarized information that can pertain to vehicle health, driving behavior, fuel consumption, etc.,
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Query Params
vehicleName:
string
Name of the vehicle (Either the vehicle name or the group name is required for the API call)
from:
required
string
Trip start timestamp in UTC with format mm-dd-yyyy HH:mm:ss
to:
required
string
Trip end timestamp in UTC with format mm-dd-yyyy HH:mm:ss
groupName:
string
Name of the group (Either the group name or the vehicle name is mandatory)
page:
integer1
Page number of the paginated result