Get Trips

POST {{base_url}}/api/v2/trip/get

Description

This API endpoint allows you to find the device information specified by the deviceId of a device on a trip, and it's associated movement paramters.

Post Request Body Contents

• deviceId (string): Specifies the device ID for which trips should be retrieved.

• fromDate (number): Specifies the starting time in milliseconds since the Unix epoch. Used to filter trips that happened at this date or after (by default start of the day).

• isGrouped (boolean): Indicates whether the retrieved trips should be grouped or not, if true will return data grouped into trip legs otherwise will return list or events.

• isNormalized (boolean): Specifies whether the retrieved trip data should be normalized, if true will return normalized(smoothened) location.

• minDuration (number): Specifies the minimum duration in milliseconds for the retrieved trips. Trips with durations less than this value will be excluded, this is used to filter out small trips that have duration less than value in milliseconds.

• minTravel (number): Specifies the minimum distance of travel in meters for the retrieved trips. Trips with travel distances less than this value will be excluded, this is used to filter out small trips that have distance less then value in meters.

Request Body

{"deviceId"=>"de0366b789d8", "fromDate"=>1635220800000, "isGrouped"=>true, "isNormalized"=>false, "minDuration"=>600000, "minTravel"=>50}

HEADERS