---
title: "List stats for all reefers"
method: GET
path: "/v1/fleet/assets/reefers"
tags: ["Assets"]
---

# List stats for all reefers

`GET /v1/fleet/assets/reefers`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/v1/fleet/assets/reefers`
- Auth: HTTP bearer

> 🚧 This endpoint is still on our legacy API.

Fetches all reefers and reefer-specific stats. 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

To use this endpoint, select **Read Trailers** under the Trailers category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

## Query parameters

- `startMs` integer, required
- `endMs` integer, required
- `startingAfter` string
- `endingBefore` string
- `limit` number

## Response `200`

All org reefers and reefer-specific details.

- InlineResponse2003
  - `data` V1AssetsReefer[]
    - `assetType` string: Asset type
    - `id` integer: Asset ID
    - `name` string: Asset name
    - `reeferStats` V1AssetsReeferReeferStats: Contains all the state changes of the reefer for the included stat types. Each state change is recorded independently, so the number of records in each array may differ depending on when that stat changed state. Stat types with a continuous value (such as temperature) will be recorded at different rates depending on the reefer, but generally readings have a frequency on the order of seconds.
      - `ambientAirTemperature` V1AssetsReeferReeferStatsAmbientAirTemperature[]: Ambient temperature of the reefer. This is the temperature of the air around the Samsara Asset Gateway.
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `tempInMilliC` integer: Ambient temperature in millidegree Celsius.
      - `dischargeAirTemperature` V1AssetsReeferReeferStatsDischargeAirTemperature[]: Discharge air temperature of the reefer. This is the temperature of the air as it leaves the cooling unit.
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `tempInMilliC` integer: Discharge temperature in millidegree Celsius.
      - `engineHours` V1AssetReeferResponseReeferStatsEngineHours[]: Engine hours of the reefer
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `engineHours` integer: Engine hours of the reefer.
      - `fuelPercentage` V1AssetReeferResponseReeferStatsFuelPercentage[]: Fuel percentage of the reefer
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `fuelPercentage` integer: Fuel percentage of the reefer.
      - `powerStatus` V1AssetsReeferReeferStatsPowerStatus[]: Power status of the reefer
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `status` 'Off' | 'Active' | 'Active (Start/Stop)' | 'Active (Continuous)': Power status of the reefer. Valid values: `Off`, `Active`, `Active (Start/Stop)`, `Active (Continuous)`.
      - `reeferAlarms` V1AssetReeferResponseReeferStatsAlarms1[]: Reefer alarms
        - `alarms` V1AssetReeferResponseReeferStatsAlarms[]
          - `alarmCode` integer: ID of the alarm
          - `description` string: Description of the alarm
          - `operatorAction` string: Recommended operator action
          - `severity` integer: Severity of the alarm: 1: OK to run, 2: Check as specified, 3: Take immediate action
        - `changedAtMs` integer: Timestamp when the alarms were reported, in Unix milliseconds since epoch
      - `returnAirTemperature` V1AssetReeferResponseReeferStatsReturnAirTemp[]: Return air temperature of the reefer. This is the temperature read by the reefer module (Carrier, Thermo King) that shows the temperature of the air as it enters the system.
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `tempInMilliC` integer: Return air temperature in millidegree Celsius.
      - `setPoint` V1AssetReeferResponseReeferStatsSetPoint[]: Set point temperature of the reefer
        - `changedAtMs` integer: Timestamp in Unix milliseconds since epoch.
        - `tempInMilliC` integer: Set point temperature in millidegree Celsius.
  - `pagination` V1Pagination
    - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'startingAfter' query parameter.
    - `hasNextPage` boolean, required: True if there are more pages of results after this response.
    - `hasPrevPage` boolean, required: True if there are more pages of results before this response.
    - `startCursor` string, required: Cursor identifier representing the first element in the response. This value should be used in conjunction with a subsequent request's 'ending_before' query parameter.

## Other responses

- `default`: Unexpected error.

---

[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)