Skip to main content
POST
Although this is a POST request, this route is not intended to create a resource in the API. It was designed this way to make it easier to customize the payload sent in the request body.

​
Request

Header
​
string
required
The bearer token used to authenticate the company.
Body
​
list of strings
required
The list of Vehicle Identification Numbers (VINs) of the vehicles whose data you want to retrieve.
  • A maximum of 20 VINs can be provided.
​
list of strings
required
The list of datapoints you want to retrieve from the vehicles.
​
date or datetime
This is an optional parameter that can be used to filter the data start date. It must be sent in one of the following formats:
  • YYYY-MM-DD For filtering purposes, the following time will be considered: YYYY-MM-DDT00:00:00-03:00 (UTC-3)
  • YYYY-MM-DDTHH:MM:SS For filtering purposes, the following time will be considered: YYYY-MM-DDTHH:MM:SS-03:00 (UTC-3)
  • YYYY-MM-DDTHH:MM:SS-ZZ:00 For filtering purposes, the exact provided time will be considered: YYYY-MM-DDTHH:MM:SS-ZZ:00 (UTC-Z)
​
date or datetime
This is also an optional parameter that can be used to filter the data end date. It must be sent in one of the following formats:
  • YYYY-MM-DD For filtering purposes, the following time will be considered: YYYY-MM-DDT00:00:00-03:00 (UTC-3)
  • YYYY-MM-DDTHH:MM:SS For filtering purposes, the following time will be considered: YYYY-MM-DDTHH:MM:SS-03:00 (UTC-3)
  • YYYY-MM-DDTHH:MM:SS-ZZ:00 For filtering purposes, the exact provided time will be considered: YYYY-MM-DDTHH:MM:SS-ZZ:00 (UTC-Z)
  • When both start_date and end_date are used, date_time will be between these two dates, as follows: end_data >= datetime >= start_date
  • When neither start_date nor end_date is used, the last 24 hours from the current moment will be requested by default
  • When only start_date is used, end_date will be considered, by default, as start_date plus 24 hours
  • When only end_date is used, start_date will be considered, by default, as end_date minus 24 hours
  • The minimum value for start_date is the current moment minus seven days
  • The maximum value for end_date is the current moment
  • The difference between start_date and end_date must be at most 24 hours

​
Response

For more detailed information about the response, see Datapoints.
​
string
The vehicle’s unique identification number.
​
datatime
The date and time of the data record [YYYY-MM-DD HH:MM:SS].
​
number or categorical
Each datapoint separately.
​
categorical
Indicates when a data point was considered erroneous and was corrected, including the data point involved, the original value, and the error type.
  • “VIN not found or unauthorized access.”: The requested VIN is invalid or is not associated with your company. Check the VIN or your permissions.
  • “Unsupported datapoint for this vehicle.”: The requested datapoint is not available for this vehicle due to OEM compatibility restrictions.
  • “Datapoint not included in your package plan.”: The requested datapoint is not available in your current plan. Contact mobway support for further assistance.
  • “No data for the given date range: start_date to end_date.”: No data was found for the specified date range (start_date to end_date). Check that the dates are correct, review the time zone, or try selecting a different period.
  • “start_date is greater than end_date.”: The start date (start_date) is later than the provided end date (end_date).
  • “start_date or end_date are out of the range of 7 days.”: The provided start or end date (start_date or end_date) is earlier than the maximum 7-day availability period.
  • “start_date or end_date are in the future.”: The provided start or end date (start_date or end_date) is later than the current moment.
  • “Difference between start_date and end_date cannot exceed 24 hours.”: The difference between start_date and end_date is greater than 24 hours.
  • “Too many VINs provided. Maximum allowed is 20.”: More than 20 VINs were provided.