BObouncie
Trip

Search Trips

get/v1/trips

Request

Query parameters

imeistring

IMEI for the vehicle to retrieve trips for

Example:123456789012345
transaction-idstring

Unique Trip Identifier

Example:123456789012345-1735920000-202501
gps-format'geojson' | 'polyline'

One of: polyline or geojson

Example:polyline
starts-afterstring date-time

Will match trips with a starting time after this parameter. The window between starts-after and ends-before must be no longer than a week. If not provided, the last week will be used by default. The earliest supported date is 2020-05-21.

Example:2026-01-01T08:30:00.000Z
ends-beforestring date-time

Will match trips with an ending time before this parameter. The earliest supported date is 2020-05-21.

Example:2026-01-02T06:00:00.000Z

Headers

Authorizationstring

User access token

Content-Type'application/json'

Response

Returns an array of trips matching given criteria

transactionIdstring required

Unique identifier

hardBrakingCountnumber required

Number of hard braking events

hardAccelerationCountnumber required

Number of hard acceleration events

distancenumber required

Distance travelled in miles

gpsstring required

GPS data encoded in requested format

startTimestring date-time required

Time trip started

endTimestring date-time required

Time trip ended

startOdometernumber required

Starting vehicle odometer

endOdometernumber required

Ending vehicle odometer

averageSpeednumber required

Average speed in MPH

maxSpeednumber required

Maximum speed in MPH

fuelConsumednumber required

Amount of fuel consumed in gallons

timeZonestring required

Time zone that vehicle was located in at the start of the trip

totalIdleDurationnumber required

Total time spent idling in seconds

imeistring required

Unique bouncie device identifier

Example response

[
  {
    "transactionId": "123456789012345-1735920000-202501",
    "hardBrakingCount": 2,
    "hardAccelerationCount": 1,
    "distance": 12.5,
    "gps": "_p~iF~ps|U_ulLnnqC_mqN",
    "startTime": "2026-01-01T010:01:00.000Z",
    "endTime": "2026-01-01T10:32:00.000Z",
    "startOdometer": 45678.9,
    "endOdometer": 45691.4,
    "averageSpeed": 35.5,
    "maxSpeed": 65,
    "fuelConsumed": 0.8,
    "timeZone": "America/Chicago",
    "totalIdleDuration": 300,
    "imei": "123456789012345"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.