🧪 List Vehicle Movement Status
Retrieve movement status for vehicles in your accessible fleets over the trailing 30 days. A vehicle is considered to have moved when it traveled at least 1000 meters in that window. Movement is determined from odometer readings when available, falling back to a GPS-derived spatial extent when odometer data is not reported. At least one of fleet_ids, fleet_refs, connection_id, or vehicle_ids must be provided. Use moved to filter the result to only vehicles that did or didn’t move. Each row carries a vehicle object with the vehicle’s identifying details.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
Filter by movement status. true returns only vehicles that traveled at least 1000 meters in the trailing 30 days; false returns only vehicles confirmed to have stayed under that threshold. Omit to return every vehicle regardless of status, including those with insufficient data (moved: null).
Limit results to specific fleets using Catena’s fleet IDs. For your own fleet identifiers, use fleet_refs instead To specify multiple values, repeat the parameter for each value (e.g., ?fleet_ids=id1&fleet_ids=id2).
Limit results to specific fleets using your organization’s fleet reference identifiers. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_refs=ref1&fleet_refs=ref2).
Limit results to specific vehicles. Maximum: 100 IDs To specify multiple values, repeat the parameter for each value (e.g., ?vehicle_ids=id1&vehicle_ids=id2).