Vehicle Related

A vehicle may have multiple drivers and a driver may have multiple vehicles.

The pairing of a user is to the combination of an VehicleMind adapter and a vehicle, not directly to the vehicle itself. What this means is that if trips are collected at different times by two different devices in the same vehicle a user would need to be registered to both devices for their token to give access to both sets of trips.

Get a specific vehicle

Returns a Vehicle Object.

Provides a single vehicle's details.

NOTE: VIN number is not necessarily available for all vehicles.

Definition

GET /vehicle/{id}/

Query Parameters

None

Example Request

curl  "https://api.vehiclemind.com/vehicle/{id}/" \
  -H "Authorization:Bearer e5cdd2a2f2c52ac2ff9825f53ac566f45c513991"

Sample Response

{
  "url": "https://api.vehiclemind.com/vehicle/C_9aa0f0e09383666c/",
  "id": "C_9aa0f0e09383666c",
  "vin": "jtmzf33v895004330",
  "created_at": "2015-07-30T17:33:32.588000Z",
  "updated_at": "2015-07-30T17:33:32.588000Z",
  "make": "Toyota",
  "model": "RAV4",
  "year": 2009,
  "submodel": "Base",
  "display_name": "My Toyota",
  "fuel_grade": "regular",
  "fuel_level_percent": 60.54,
  "battery_voltage": 12.4,
  "active_dtcs": [
    {
      "code": "B0078",
      "created_at": "2015-09-29T23:55:46.123Z",
      "description": "Third Row Right Seatbelt Pretensioner Deployment Control"
    }
  ]
}

Get a list of vehicles

Returns an array of Vechile Objects.

Provides a listing of vehicles that match the query parameters.

Definition

GET /vehicle/

Query Parameters

Parameter Description
created_at_lte
Optional, default is null
(INTEGER) Start time (<=) filter in seconds since epoch time. e.g. "2015-may-9 16:00 gmt-8"="1431126000
created_at_gte
Optional, default is null
(INTEGER) Start time (>=) filter in seconds since epoch time. e.g. "2015-May-9 16:00 GMT-8" = 1431126000
updated_at_lte
Optional, default is null
(INTEGER) End time (<=) filter in seconds since epoch time. e.g. "2015-may-9 16:00 gmt-8"="1431126000
updated_at_gte
Optional, default is null
(INTEGER) End time (>=) filter in seconds since epoch time. e.g. "2015-May-9 16:00 GMT-8" = 1431126000
vin
Optional, default is null
(STRING) VIN Filter
page
Optional, default is 1
(INTEGER) Specifies the page of paginated results to return.
limit
Optional, default is 10, max is 250. Though accounts have lower limits on vehicles that can be attached to an account.
(INTEGER) Number of results per page

Example Request

curl  "https://api.vehiclemind.com/vehicle/" \
  -H "Authorization:Bearer e5cdd2a2f2c52ac2ff9825f53ac566f45c513991"

Sample Response

{
  "_metadata": {
    "count": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "url": "https://api.vehiclemind.com/vehicle/C_9aa0f0e09383666c/",
      "id": "C_9aa0f0e09383666c",
      "vin": "jtmzf33v895004330",
      "created_at": "2015-07-30T17:33:32.588000Z",
      "updated_at": "2015-07-30T17:33:32.588000Z",
      "make": "Toyota",
      "model": "RAV4",
      "year": 2009,
      "submodel": "Base",
      "display_name": "My Toyota",
      "fuel_grade": "regular",
      "fuel_level_percent": 60.54,
      "battery_voltage": 12.4,
      "active_dtcs": [
        {
          "code": "B0078",
          "created_at": "2015-09-29T23:55:46.123Z",
          "description": "Third Row Right Seatbelt Pretensioner Deployment Control"
        }
      ]
    }
  ]
}

List a vehicle's MIL history events

Returns an array of VehicleMILHistory Objects.

Definition

GET /vehicle/{vehicle_id}/mil/

Query Parameters

Parameter Description
vehicle_id
Optional, default is null
Not provided
page
Optional, default is 1
(INTEGER) Specifies the page of paginated results to return.
limit
Optional, default is 10, max is 250. Though accounts have lower limits on vehicles that can be attached to an account.
(INTEGER) Number of results per page

Example Request

curl  "https://api.vehiclemind.com/vehicle/{vehicle_id}/mil/" \
  -H "Authorization:Bearer e5cdd2a2f2c52ac2ff9825f53ac566f45c513991"

Sample Response

{
  "_metadata": {
    "count": 2,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "code": "B0078",
      "on": true,
      "created_at": "2015-09-30T08:10:31Z",
      "description": "Third Row Right Seatbelt Pretensioner Deployment Control"
    },
    {
      "code": "B0079",
      "on": false,
      "created_at": "2015-08-30T08:06:43Z",
      "description": "Driver Seatbelt Pretensioner \"B\" Deployment Control"
    }
  ]
}