curl -H "X-API-Key: YOUR_API_KEY" \
"https://your-api-host/trips/ABC123?from=2025-12-01T00:00:00Z&to=2025-12-17T00:00:00Z"
{
"trips": [
{
"hardware_id": "ABC123",
"startTime": "2025-12-17T08:00:00.000Z",
"endTime": "2025-12-17T08:45:00.000Z",
"startLocation": { "lat": 37.7749, "long": -122.4194 },
"endLocation": { "lat": 37.7899, "long": -122.401 },
"distance": 5234,
"duration": 2700,
"maxSpeed": 45.2,
"avgSpeed": 6.9,
"pointCount": 54
}
],
"stops": [
{
"startTime": "2025-12-17T08:45:00.000Z",
"endTime": "2025-12-17T09:30:00.000Z",
"location": { "lat": 37.7899, "long": -122.401 },
"duration": 2700
}
],
"summary": {
"totalTrips": 1,
"totalStops": 1,
"totalDistance": 5234,
"totalDuration": 2700,
"totalStopDuration": 2700,
"positionsAnalyzed": 120,
"configUsed": {
"speedThreshold": 3,
"minimalTripDuration": 300,
"minimalTripDistance": 500,
"minimalParkingDuration": 180,
"minimalNoDataDuration": 1800,
"minimalAvgSpeed": 1,
"maxAcceleration": 10
}
}
}
Trips
Get Device Trips
Get trips and stops for a single device within a date range.
GET
/
trips
/
{id}
curl -H "X-API-Key: YOUR_API_KEY" \
"https://your-api-host/trips/ABC123?from=2025-12-01T00:00:00Z&to=2025-12-17T00:00:00Z"
{
"trips": [
{
"hardware_id": "ABC123",
"startTime": "2025-12-17T08:00:00.000Z",
"endTime": "2025-12-17T08:45:00.000Z",
"startLocation": { "lat": 37.7749, "long": -122.4194 },
"endLocation": { "lat": 37.7899, "long": -122.401 },
"distance": 5234,
"duration": 2700,
"maxSpeed": 45.2,
"avgSpeed": 6.9,
"pointCount": 54
}
],
"stops": [
{
"startTime": "2025-12-17T08:45:00.000Z",
"endTime": "2025-12-17T09:30:00.000Z",
"location": { "lat": 37.7899, "long": -122.401 },
"duration": 2700
}
],
"summary": {
"totalTrips": 1,
"totalStops": 1,
"totalDistance": 5234,
"totalDuration": 2700,
"totalStopDuration": 2700,
"positionsAnalyzed": 120,
"configUsed": {
"speedThreshold": 3,
"minimalTripDuration": 300,
"minimalTripDistance": 500,
"minimalParkingDuration": 180,
"minimalNoDataDuration": 1800,
"minimalAvgSpeed": 1,
"maxAcceleration": 10
}
}
}
Returns computed trips and stops for a single device. The
id path parameter accepts either short_id or hardware_id.
Path parameters
string
required
Device identifier — either
short_id or hardware_id.Query parameters
string
required
ISO 8601 date string (start of time range).
string
required
ISO 8601 date string (end of time range). Max range: 31 days.
number
default:"3"
km/h — below this speed is considered stopped.
number
default:"300"
Seconds — minimum moving time to count as a trip.
number
default:"500"
Meters — minimum distance to count as a trip.
number
default:"180"
Seconds — minimum stopped time to end a trip.
number
default:"1800"
Seconds — data gaps longer than this are treated as stops.
number
default:"1"
km/h — minimum average speed to count as a trip.
number
default:"10"
m/s² — filter GPS spikes exceeding this value.
Response
Same shape as Get Trips (withoutdevicesQueried in summary).
curl -H "X-API-Key: YOUR_API_KEY" \
"https://your-api-host/trips/ABC123?from=2025-12-01T00:00:00Z&to=2025-12-17T00:00:00Z"
{
"trips": [
{
"hardware_id": "ABC123",
"startTime": "2025-12-17T08:00:00.000Z",
"endTime": "2025-12-17T08:45:00.000Z",
"startLocation": { "lat": 37.7749, "long": -122.4194 },
"endLocation": { "lat": 37.7899, "long": -122.401 },
"distance": 5234,
"duration": 2700,
"maxSpeed": 45.2,
"avgSpeed": 6.9,
"pointCount": 54
}
],
"stops": [
{
"startTime": "2025-12-17T08:45:00.000Z",
"endTime": "2025-12-17T09:30:00.000Z",
"location": { "lat": 37.7899, "long": -122.401 },
"duration": 2700
}
],
"summary": {
"totalTrips": 1,
"totalStops": 1,
"totalDistance": 5234,
"totalDuration": 2700,
"totalStopDuration": 2700,
"positionsAnalyzed": 120,
"configUsed": {
"speedThreshold": 3,
"minimalTripDuration": 300,
"minimalTripDistance": 500,
"minimalParkingDuration": 180,
"minimalNoDataDuration": 1800,
"minimalAvgSpeed": 1,
"maxAcceleration": 10
}
}
}