--- title: "Get trailer stats" method: GET path: "/fleet/trailers/stats" tags: ["Trailers"] --- # Get trailer stats `GET /fleet/trailers/stats` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/fleet/trailers/stats` - Auth: HTTP bearer Returns the last known stats of all trailers at the given `time`. If no `time` is specified, the current time is used. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trailer Statistics** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. ## Query parameters - `types` string, required - `tagIds` string - `parentTagIds` string - `after` string - `trailerIds` string - `time` string ## Response `200` OK response. - TrailerStatsGetTrailerStatsSnapshotResponseBody - `data` TrailerStatsSnapshotObjectResponseBody[], required: List of trailers and their stats - `carrierReeferState` TrailerStatReeferStateTypeResponseBody: Reefer state event. - `substateValue` string: The substate of the multizone carrier reefer, if available. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` string, required: The overall state of the multizone carrier reefer. - `externalIds` object: A map of external ids - `gps` TrailerStatGpsTypeResponseBody: GPS location data for the trailer. - `headingDegrees` integer: Heading of the trailer in degrees. - `latitude` number, double, required: GPS latitude represented in degrees. - `longitude` number, double, required: GPS longitude represented in degrees. - `reverseGeo` ReverseGeoObjectResponseBody: Reverse geocoded information - `formattedLocation` string: Formatted address of the reverse geocoding data. - `speedMilesPerHour` integer: GPS speed of the trailer in miles per hour. - `time` string, required: UTC timestamp in RFC 3339 format. - `gpsOdometerMeters` TrailerStatGpsOdometerMetersTypeResponseBody: Trailer GPS odometer event. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: Number of meters the trailer has traveled according to the GPS calculations and the manually specified odometer reading. - `id` string, required: ID of the trailer. - `name` string, required: Name of the vehicle. - `reeferAlarms` TrailerStatReeferAlarmTypeResponseBody: Alarms that have been emitted by the reefer. - `alarms` TrailerStatReeferAlarmResponseBody[], required: The alarms reported by the reefer. - `alarmCode` string, required: The ID of the alarm. - `description` string, required: The description of the alarm. - `operatorAction` string, required: The recommended operator action. - `severity` integer, required: The severity of the alarm. `1`: Ok to run, `2`: Check as specified, `3`: Take immediate action. - `time` string, required: UTC timestamp in RFC 3339 format. - `reeferAmbientAirTemperatureMilliC` TrailerStatReeferAmbientAirTemperatureMilliCTypeResponseBody: Reefer ambient air temperature reading. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The ambient air temperature reading of the reefer in millidegree Celsius. - `reeferDoorStateZone1` TrailerStatReeferDoorStateZone1TypeResponseBody: The door state of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` 'open' | 'closed', required: The door state of zone 2 of the reefer. Valid values: `open`, `closed` - `reeferDoorStateZone2` TrailerStatReeferDoorStateZone2TypeResponseBody: The door state of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` 'open' | 'closed', required: The door state of zone 2 of the reefer. Valid values: `open`, `closed` - `reeferDoorStateZone3` TrailerStatReeferDoorStateZone3TypeResponseBody: The door state of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` 'open' | 'closed', required: The door state of zone 2 of the reefer. Valid values: `open`, `closed` - `reeferFuelPercent` TrailerStatReeferFuelPercentTypeResponseBody: The fuel percentage of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The fuel level in percentage points (e.g. `99`, `50`, etc). - `reeferObdEngineSeconds` TrailerStatReeferObdEngineSecondsTypeResponseBody: Reefer onboard engine seconds reading. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The number of seconds the reefer has been on according to the onboard diagnostics. - `reeferReturnAirTemperatureMilliCZone1` TrailerStatReeferReturnAirTemperatureMilliCZone1TypeResponseBody: Return air temperature of zone 1 of the reefer. This is the temperature of the air as it enters the cooling unit. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The return air temperature reading in millidegree Celsius. - `reeferReturnAirTemperatureMilliCZone2` TrailerStatReeferReturnAirTemperatureMilliCZone2TypeResponseBody: Return air temperature of zone 2 of the reefer. This is the temperature of the air as it enters the cooling unit. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The return air temperature reading in millidegree Celsius. - `reeferReturnAirTemperatureMilliCZone3` TrailerStatReeferReturnAirTemperatureMilliCZone3TypeResponseBody: Return air temperature of zone 3 of the reefer. This is the temperature of the air as it enters the cooling unit. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The return air temperature reading in millidegree Celsius. - `reeferRunMode` TrailerStatReeferRunModeTypeResponseBody: The run mode of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` string, required: The operational mode of the reefer. - `reeferSetPointTemperatureMilliCZone1` TrailerStatReeferSetPointTemperatureMilliCZone1TypeResponseBody: Set point temperature of zone 1 of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The set point temperature reading in millidegree Celsius. - `reeferSetPointTemperatureMilliCZone2` TrailerStatReeferSetPointTemperatureMilliCZone2TypeResponseBody: Set point temperature of zone 2 of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The set point temperature reading in millidegree Celsius. - `reeferSetPointTemperatureMilliCZone3` TrailerStatReeferSetPointTemperatureMilliCZone3TypeResponseBody: Set point temperature of zone 3 of the reefer. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The set point temperature reading in millidegree Celsius. - `reeferStateZone1` TrailerStatReeferStateZone1TypeResponseBody: Reefer state event. - `substateValue` string: The substate zone 1 of the reefer, if available. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` string, required: The state zone 1 of the reefer. - `reeferStateZone2` TrailerStatReeferStateZone2TypeResponseBody: Reefer state event. - `substateValue` string: The substate zone 2 of the reefer, if available. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` string, required: The state zone 2 of the reefer. - `reeferStateZone3` TrailerStatReeferStateZone3TypeResponseBody: Reefer state event. - `substateValue` string: The substate zone 3 of the reefer, if available. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` string, required: The state zone 3 of the reefer. - `reeferSupplyAirTemperatureMilliCZone1` TrailerStatReeferSupplyAirTemperatureMilliCZone1TypeResponseBody: Supply or discharge air temperature of zone 2 of the reefer. This is the temperature of the air as it leaves the cooling unit. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The supply or discharge air temperature reading in millidegree Celsius. - `reeferSupplyAirTemperatureMilliCZone2` TrailerStatReeferSupplyAirTemperatureMilliCZone2TypeResponseBody: Supply or discharge air temperature of zone 2 of the reefer. This is the temperature of the air as it leaves the cooling unit. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The supply or discharge air temperature reading in millidegree Celsius. - `reeferSupplyAirTemperatureMilliCZone3` TrailerStatReeferSupplyAirTemperatureMilliCZone3TypeResponseBody: Supply or discharge air temperature of zone 2 of the reefer. This is the temperature of the air as it leaves the cooling unit. - `time` string, required: UTC timestamp in RFC 3339 format. - `value` integer, required: The supply or discharge air temperature reading in millidegree Celsius. - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters. - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view. - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor. ## Other responses - `401`: Unauthorized response. - `404`: Not Found response. - `405`: Method Not Allowed response. - `413`: Content Too Large response. - `429`: Too Many Requests response. - `500`: Internal Server Error response. - `501`: Not Implemented response. - `502`: Bad Gateway response. - `503`: Service Unavailable response. - `504`: Gateway Timeout response. - `default`: Bad Request response. --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)