Get Device Active Trip

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/trips/ABC123/active?maxAgeSeconds=180"

{
  "hardware_id": "ABC123",
  "active": true,
  "activeTrip": {
    "hardware_id": "ABC123",
    "speed": 19.6,
    "last_position_at": "2025-12-17T10:30:00.000Z",
    "last_position_age_seconds": 24,
    "location": { "lat": 37.7749, "long": -122.4194 },
    "trip": {
      "startTime": "2025-12-17T09:50:00.000Z",
      "endTime": "2025-12-17T10:30:00.000Z",
      "startLocation": { "lat": 37.7601, "long": -122.4312 },
      "endLocation": { "lat": 37.7749, "long": -122.4194 },
      "distance": 5234,
      "duration": 2400,
      "maxSpeed": 45.2,
      "avgSpeed": 7.8,
      "pointCount": 54
    }
  },
  "summary": {
    "configUsed": {
      "speedThreshold": 3,
      "minimalTripDuration": 300,
      "minimalTripDistance": 500,
      "minimalParkingDuration": 180,
      "minimalNoDataDuration": 1800,
      "minimalAvgSpeed": 1,
      "maxAcceleration": 10
    },
    "maxAgeSeconds": 180,
    "lookbackSeconds": 14400
  }
}

GET

trips

{id}

active

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/trips/ABC123/active?maxAgeSeconds=180"

{
  "hardware_id": "ABC123",
  "active": true,
  "activeTrip": {
    "hardware_id": "ABC123",
    "speed": 19.6,
    "last_position_at": "2025-12-17T10:30:00.000Z",
    "last_position_age_seconds": 24,
    "location": { "lat": 37.7749, "long": -122.4194 },
    "trip": {
      "startTime": "2025-12-17T09:50:00.000Z",
      "endTime": "2025-12-17T10:30:00.000Z",
      "startLocation": { "lat": 37.7601, "long": -122.4312 },
      "endLocation": { "lat": 37.7749, "long": -122.4194 },
      "distance": 5234,
      "duration": 2400,
      "maxSpeed": 45.2,
      "avgSpeed": 7.8,
      "pointCount": 54
    }
  },
  "summary": {
    "configUsed": {
      "speedThreshold": 3,
      "minimalTripDuration": 300,
      "minimalTripDistance": 500,
      "minimalParkingDuration": 180,
      "minimalNoDataDuration": 1800,
      "minimalAvgSpeed": 1,
      "maxAcceleration": 10
    },
    "maxAgeSeconds": 180,
    "lookbackSeconds": 14400
  }
}

Returns active trip status for a single device based on its latest GPS sample. 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

number

default:"300"

Maximum age of latest GPS sample in seconds.

number

default:"14400"

How far back to load GPS history for trip detection.

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

string

required

Device hardware ID.

boolean

required

Whether the device is currently in motion.

object

Present when active is true. Contains hardware_id, speed, last_position_at, last_position_age_seconds, location, and trip data.

object

required

Configuration and parameters used for detection.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://your-api-host/trips/ABC123/active?maxAgeSeconds=180"

{
  "hardware_id": "ABC123",
  "active": true,
  "activeTrip": {
    "hardware_id": "ABC123",
    "speed": 19.6,
    "last_position_at": "2025-12-17T10:30:00.000Z",
    "last_position_age_seconds": 24,
    "location": { "lat": 37.7749, "long": -122.4194 },
    "trip": {
      "startTime": "2025-12-17T09:50:00.000Z",
      "endTime": "2025-12-17T10:30:00.000Z",
      "startLocation": { "lat": 37.7601, "long": -122.4312 },
      "endLocation": { "lat": 37.7749, "long": -122.4194 },
      "distance": 5234,
      "duration": 2400,
      "maxSpeed": 45.2,
      "avgSpeed": 7.8,
      "pointCount": 54
    }
  },
  "summary": {
    "configUsed": {
      "speedThreshold": 3,
      "minimalTripDuration": 300,
      "minimalTripDistance": 500,
      "minimalParkingDuration": 180,
      "minimalNoDataDuration": 1800,
      "minimalAvgSpeed": 1,
      "maxAcceleration": 10
    },
    "maxAgeSeconds": 180,
    "lookbackSeconds": 14400
  }
}

Devices

Telemetry

Lock Events

Trips

WebSocket

Path parameters

Query parameters

Response

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response