Device Info

Information specific to a VOYO device.

GetDevices

Request a list of all devices connected to the account provided VOYO API key belongs to.

Request

curl -L -X GET 'https://{DOMAIN}/voyorequest/Devices

-H 'Accept: application/json'
-H 'Authorization: Bearer {APIKEY}'

Empty Response

An account with no associated devices will return the following:

    HTTP/1.1 204 No Content

{ "error":"Success!" }

Success Responses

Returns a list of VOYO devices with the following attributes:

Parameters	Description
serial	Unique device identifier.
name	A user defined string used to identify this device.
vin	The last known VIN associated with this device.
version	String used to identify the current revision for this device.
mac	Unique MAC address (int).
imei	Unique IMEI.
connected_users	An array of User keys. Can be an empty array if no Users are linked to this device.

mac and imei are not included for Bluetooth only units.

The following parameter data is also included per device and represents the most recent vehicle the VOYO device was connected to:

Parameters	Description
make	Vehicle make.
model	Vehicle model.
year	Vehicle model year.
odometer	Current vehicle mileage.
left_front_tire_pressure	Left front tire pressure.
right_front_tire_pressure	Right front tire pressure.
left_rear_tire_pressure	Left rear tire pressure.
right_rear_tire_pressure	Right rear tire pressure.
fuel_level	Percentage fuel remaining.
oil_life	Oil life percentage.
ambient_air_temperature	Ambient air temperature.
mil_status	MIL status.
latitude	GPS latitude.
longitude	GPS longitude.
last_connected	Unix timestamp representing the last time the device connected.

The parameters above will be excluded if they are not available.

Example

Response devices can be empty if there are no VOYO devices associated with the VOYO API key provided.
Response connected_users can be empty if there are no Users linked to the returned VOYO device. Otherwise, connected_users is an array of user_key strings.

{
    "devices":[
        {
            "serial":"",
            "name":"",
            "vin":"",
            "version":"",
            "mac":"",
            "imei":"",
            "connected_users":[]
        },
        {
            "serial":"",
            "name":"",
            "vin":"",
            "version":"",
            "connected_users":[]
        },
        {
            "serial":"",
            "name":"",
            "vin":"",
            "version":"",
            "mac":"",
            "imei":"",
            "make":"",
            "model":"",
            "year":"",
            "odometer":"",
            "fuel_level":"",
            "oil_life":"",
            "mil_status":"",
            "connected_users":[]
        } 
    ]
}