--- title: "Historical Vehicle Stats" method: GET path: "/vehicles/{vehicleId}/stats/historical" tags: ["Vehicles"] --- # Historical Vehicle Stats `GET /vehicles/{vehicleId}/stats/historical` ## Request - Base URL: `https://api.withterminal.com/tsp/v1` - URL: `https://api.withterminal.com/tsp/v1/vehicles/{vehicleId}/stats/historical` - Auth: HTTP bearer List historical stats and logs about the vehicle. ## Query parameters - `cursor` string, cursor - `limit` integer - `expand` 'vehicle' - `startAt` string, date-time - `endAt` string, date-time - `types` string - `raw` boolean ## Headers - `X-Application-Id` string - `Connection-Token` string, required ## Response `200` OK - object - `results` VehicleStatLog[], required - union - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_state', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `state` 'on' | 'off' | 'idle', required - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'odometer', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `odometer` number, double, required: Distance in kilometers - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'total_fuel_consumption', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `fuelConsumed` number, required: Volume in liters rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'fuel_level', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `fuelPercentage` number, required: The percentage value of how much fuel is left in the tank. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_runtime', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `duration` integer, required: Duration in MS - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_oil_percentage', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `percentage` number, required: Percentage value between 0 and 100, rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_oil_pressure', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `pressure` number, required: Pressure in PSI (Pounds per Square Inch) rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_oil_temperature', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `temperature` number, required: Temperature in Celsius rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_coolant_temperature', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `temperature` number, required: Temperature in Celsius rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'coolant_percentage', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `percentage` number, required: Percentage value between 0 and 100, rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'engine_rpm', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `rpm` number, required: Engine RPM (Revolutions Per Minute) rounded to 2 decimal places. - object - `id` string, ulid, required - `sourceId` string: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'battery_voltage', required - `timestamp` string, date-time, required: [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `vehicle` union, required - string, ulid: Unique identifier for the vehicle in Terminal. - ExpandedVehicle - `id` string, ulid, required: Unique identifier for the vehicle in Terminal. - `sourceId` string, required: The ID used to represent the entity in the source system. - `provider` string, required: Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `status` 'active' | 'inactive', required: The status in the providers system - `vin` string - `name` string - `make` string - `model` string - `year` integer - `groups` GroupId[]: The groups the vehicle belongs to. - `devices` DeviceId[]: The devices installed in the vehicle. - `licensePlate` object - … - `fuelType` 'gasoline' | 'diesel' | 'propane' | 'electric' | 'hybrid_gasoline' | 'hybrid_diesel' | 'biodiesel' | 'compressed_natural_gas' | 'liquefied_natural_gas' | 'ethanol' | 'hydrogen' | 'plug_in_hybrid' - `fuelEfficiency` number: This field will be removed in the future as is not commonly available from providers. - `fuelTankCapacity` number: Maximum amount of fuel vehicle can hold in liters. - `createdAt` string, date-time: The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. - `updatedAt` string, date-time: The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. - `metadata` CoreEntityMetadata, required: Internal metadata about the record. - … - `raw` RawData[] - … - `metadata` TimeSeriesMetadata, required: Internal metadata about the time series. - `modifiedAt` string, date-time, required: The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` RawData[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `voltage` number, required: Voltage in volts rounded to 2 decimal places. - `next` string, cursor: Cursor used for pagination. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `410`: Gone - `429`: Too Many Requests - `500`: Internal Server Error - `504`: Gateway Timeout Error ## Changes - **2026-11-03** `71081936e1bd`: 2 breaking, 1 warning, 3 info - added the pattern `^[A-Za-z0-9+/=_-]+$` to the `query` request parameter `cursor` - added `#/components/schemas/ExpandedVehicle` to the `results/items/vehicle` response property `oneOf` list for the response status `200` - added the new `provider_timeout` enum value to the `code` response property for the response status `504` - added the non-success response with the status `410` - …2 more [Operation history](https://skmtc.dev/withterminal/apis/terminal-telematics-api/changes/vehicles/:vehicleId/stats/historical/get.md) --- [API](https://skmtc.dev/withterminal/apis/terminal-telematics-api.md) - [All operations](https://skmtc.dev/withterminal/apis/terminal-telematics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withterminal/apis/terminal-telematics-api/revisions/a9f825034fd3?raw)