Get Trips

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/trips?hardware_ids=ABC123&hardware_ids=DEF456&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,
    "devicesQueried": 2,
    "configUsed": {
      "speedThreshold": 3,
      "minimalTripDuration": 300,
      "minimalTripDistance": 500,
      "minimalParkingDuration": 180,
      "minimalNoDataDuration": 1800,
      "minimalAvgSpeed": 1,
      "maxAcceleration": 10
    }
  }
}

GET

trips

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/trips?hardware_ids=ABC123&hardware_ids=DEF456&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,
    "devicesQueried": 2,
    "configUsed": {
      "speedThreshold": 3,
      "minimalTripDuration": 300,
      "minimalTripDistance": 500,
      "minimalParkingDuration": 180,
      "minimalNoDataDuration": 1800,
      "minimalAvgSpeed": 1,
      "maxAcceleration": 10
    }
  }
}

Returns computed trips and stops from GPS telemetry for multiple devices. Trips are computed on-demand using motion detection.

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.

string[]

Filter by hardware IDs. Repeated or comma-separated. Max 50 devices per request. Results are automatically scoped to devices you have access to.

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

object[]

required

Show Trip object

string

required

Device hardware ID.

string

required

Trip start time (ISO 8601).

string

required

Trip end time (ISO 8601).

object

required

Start coordinates (lat, long).

object

required

End coordinates (lat, long).

number

required

Distance in meters.

number

required

Duration in seconds.

number

required

Maximum speed in km/h.

number

required

Average speed in km/h.

number

required

Number of GPS points in the trip.

object[]

required

Show Stop object

string

required

Stop start time (ISO 8601).

string

required

Stop end time (ISO 8601).

object

required

Stop coordinates (lat, long).

number

required

Duration in seconds.

object

required

Show Summary

number

required

Total trips found.

number

required

Total stops found.

number

required

Total distance in meters.

number

required

Total trip duration in seconds.

number

required

Total stop duration in seconds.

number

required

GPS positions processed.

number

required

Number of devices queried.

object

required

Trip detection parameters used.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/trips?hardware_ids=ABC123&hardware_ids=DEF456&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,
    "devicesQueried": 2,
    "configUsed": {
      "speedThreshold": 3,
      "minimalTripDuration": 300,
      "minimalTripDistance": 500,
      "minimalParkingDuration": 180,
      "minimalNoDataDuration": 1800,
      "minimalAvgSpeed": 1,
      "maxAcceleration": 10
    }
  }
}

Devices

Telemetry

Lock Events

Trips

WebSocket

Query parameters

Response

​Query parameters

​Response

Query parameters

Response