---
title: "Search Trips"
method: GET
path: "/v1/trips"
tags: ["Trip"]
---

# Search Trips

`GET /v1/trips`

## Query parameters

- `imei` string — IMEI for the vehicle to retrieve trips for
- `transaction-id` string — Unique Trip Identifier
- `gps-format` 'geojson' | 'polyline' — One of: `polyline` or `geojson`
- `starts-after` string, 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.
- `ends-before` string, date-time — Will match trips with an ending time before this parameter. The earliest supported date is 2020-05-21.

## Headers

- `Authorization` string — User access token
- `Content-Type` 'application/json'

## Response `200`

Returns an array of trips matching given criteria

- object[]
  - `transactionId` string, required — Unique identifier
  - `hardBrakingCount` number, required — Number of hard braking events
  - `hardAccelerationCount` number, required — Number of hard acceleration events
  - `distance` number, required — Distance travelled in miles
  - `gps` string, required — GPS data encoded in requested format
  - `startTime` string, date-time, required — Time trip started
  - `endTime` string, date-time, required — Time trip ended
  - `startOdometer` number, required — Starting vehicle odometer
  - `endOdometer` number, required — Ending vehicle odometer
  - `averageSpeed` number, required — Average speed in MPH
  - `maxSpeed` number, required — Maximum speed in MPH
  - `fuelConsumed` number, required — Amount of fuel consumed in gallons
  - `timeZone` string, required — Time zone that vehicle was located in at the start of the trip
  - `totalIdleDuration` number, required — Total time spent idling in seconds
  - `imei` string, required — Unique bouncie device identifier

---

[API](https://skmtc.net/bouncie/apis/bouncie-api.md) · [All operations](https://skmtc.net/bouncie/apis/bouncie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bouncie/bouncie-api/versions/7b4fc4cc0eb9/schema)