Live Position Latest
Returns the live position and status for a resource (driver or vehicle). The live position for a vehicle on a private journey is not returned. By default vehicles which have a status of SOLD are not included in the response.
This endpoint can be used to return details for only those vehicles where tracking data has been processed since a specified processed date/time as follows:
- Call the endpoint and do not specify a value for fromDateTime
- In the next call to this endpoint, specify the value for fromDateTime to be processedDateTime from the previous call
If fromDateTime is specified, then only vehicles where tracking information has been processed since the specified date/time are included in the output response. An error is returned if the value specified for fromDateTime is more than one day in the past. No details are returned if the value specified for fromDateTime is a future date.
Request Limit:
The request limit on this endpoint is one request every 15 seconds. You will receive an HTTP status code of 429 (too many requests) and no details will be returned if you exceed this restriction.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Comma separated list of vehicle identifiers (alphanumeric).
Comma separated list of group ids.
Comma separated list of driver identifiers (alphanumeric).
Start date and time for the tracking data retrieval
Boolean (true/false) to indicate if details of all vehicles should be included, irrespective of their status. If not specified, defaults to FALSE, so vehicles with a status of SOLD are excluded from the response.
Locale for the response data.
Boolean (true/false) to indicate if the vehicle speed should be excluded from the output if the driver;'s group (if there is a driver for the vehicle) or the vehicle's group has been defined to be speed sensitive. If not specified, defaults to FALSE, so the vehicle's speed is included in the response.
Response
Latest live position data successfully returned
