The JumpDrive Partner API function ” getCurrentData” allows partners to access current data about vehicles by passing VIN along with the configured username and password.

Getting Started

Our Partner API requires the following to retrieve vehicle fuel and mileage information:

1. API URL, Username and Password (please email partner@jumpdrive.com for API URL and your credentials)
2. Vehicle Identification Number (VIN) to get it’s return details.
3. Familiarity with a programming language supporting REST calls (PHP, Ruby, .NET, Python, etc.)

For best results, we recommend querying the API during the check out process on demand.

Steps For Using the API

1. Create a script to call our API URL (will be provided via email upon request) and pass your username, password, VIN and response format.  By default all results are in XML, for example – getCurrentData(username, password, VIN, format).  For JSON formatted results, use getCurrentData(username, password, VIN, ‘json’) and for XML formatted results use getCurrentData(username, password, VIN, ‘xml’).
2. If you receive the message “Invalid Username and/or Password”, please contact partner@jumpdrive.com and we will confirm your credentials.

Sample XML/JSON results

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<root>
   <VIN>5GAKRBED0BJ315901</VIN>
   <JumpDriveID>ffff31</JumpDriveID>
   <LotID>218</LotID>
   <LotName>Pine Ridge</LotName>
   <LastTimeIn>2015-04-11 13:01:48</LastTimeIn>
   <StartMileage>42646</StartMileage>
   <LastMileage>36645</LastMileage>
   <FuelPercent>34.48</FuelPercent>
   <FuelVolume>20.88</FuelVolume>
</root>

Sample JSON Response

[{"VIN":"5GAKRBED0BJ315901","JumpDriveID":"ffff31","LotID":"218","LotName":"Pine Ridge","LastTimeIn":"2015-04-11 13:01:48","StartMileage":"42646","LastMileage":"36645","FuelPercent":"34.48","FuelVolume":"20.88"}]

Description Of Each Field Showing In XML/JSON Responses Above

1. VIN = Vehicle Identification Number
2. JumpDriveID = JumpDrive device ID assigned to each customer
3. LotID = ID of the current location of the vehicle
4. LotName = Name of the current location of the vehicle
5. LastTimeIn = Most recent time when vehicle checked in (in local time zone)
6. StartMileage = Starting mileage (in km) of vehicle when it was registered with a JumpDrive Vehicle Device.  If this value is 0, the vehicle mileage was not registered and mileage value will not be up to date.
7. LastMileage = Latest vehicle mileage (in km)
8. FuelPercent = Current percentage of fuel tank full (100% is full, 0% is empty)
9. FuelVolume = Current fuel volume in fuel tank, in liters

Additional questions?

Please email support@jumpdrive.com if you have any questions or require additional support.