Vehicle & Driver Filtering
Overview
Terminal allows you to filter vehicle and driver data by status (active/inactive) and by specific Terminal IDs. These filters enable you to limit the data pulled from provider systems to only what is relevant to you.
Common Use Cases
- Reducing Data Volume and Costs: Limit ingestion to only active vehicles/drivers. This is especially valuable for fleets with many inactive vehicles.
- Multi-Fleet TSP Accounts: For fleets that share TSP (Telematics Service Provider) accounts with other fleets, you can selectively ingest only vehicles/drivers which are part of the relevant fleet.
Filter Structure
You can set filters on a given connection using a JSON structure that specifies filter criteria.
Available Filter Options:
status
: Filter by vehicle/driver status (e.g.active
to include only active vehicles/drivers)excludeIds
: Array of Terminal Vehicle/Driver IDs to exclude from data ingestion
Applying Filters
For Existing Connections
You can add or update filters on existing connections using the PATCH /connections/current
endpoint. Include the filters
object in your request body with the desired configuration.
To view the current filters applied to a connection, use the GET /connections/current
endpoint.
For New Connections
-
Initial Setup: When creating a new connection with filtering, Terminal first needs to perform an initial sync to identify all vehicles and drivers. To prevent ingesting unnecessary data before applying filters:
- Set sync mode to
manual
- Set
backfill
days to0
Configure these sync settings through the
Link Component
or in the Terminal Dashboard underAdd Connections
->Advanced Options
. - Set sync mode to
-
Complete Initial Discovery: Allow the first sync to complete. This identifies all vehicles and drivers without pulling their historical data.
-
Apply Your Filters: After the initial sync, use the
PATCH /connections/current
endpoint to set relevant vehicle and driver filters. -
Historical Data (Optional): If you need historical data, request a backfill after applying filters. This ensures you only retrieve historical data for filtered vehicles and drivers.
-
Enable Automatic Syncing: For ongoing data collection, change the sync mode to
automatic
. This keeps your data current while respecting your filters.
This approach ensures you only ingest data for vehicles and drivers that match your filter criteria, both for historical and future data collection.