List sensor samples for Reefers

Purpose: This endpoint returns all available sensor samples for one or more assets (reefers) within the requested time range.

NOTE: Any unknown asset IDs are ignored; only known assets are included in the response.

📘

IMPORTANT

This is a read-only POST endpoint. It does not create any server-side resource. It returns reefer sensor samples for the requested assets and time range.

POST is used to accommodate large request bodies (for example, hundreds of asset IDs) that could exceed standard URL length limits if sent via GET.

Response Parameters

assets

• Type: Array
• Description: List of asset entries. Each entry includes asset metadata and associated reefer sensor samples for the requested time range.

asset

• Type: Object
• Description: Asset metadata for the reefer.

asset_gateway

• Type: Object
• Description: Asset gateway information linked to the asset.

id

• Type: Integer
• Description: Unique identifier. For asset entries, this is the asset ID; for asset_gateway, this is the gateway ID.

name

• Type: String
• Description: Human-readable asset name.

identifier

• Type: String
• Description: Hardware identifier of the asset gateway.

reefer_samples

• Type: Array
• Description: Per-sensor groups of reefer samples recorded for the asset.

sensor_id

• Type: String
• Description: Unique identifier of the sensor device that produced the samples.

zone_number

• Type: Integer
• Description: Zone number within the reefer where the sensor is located.

zone_location

• Type: String
• Description: Zone placement label (e.g., front, middle, back).

samples_count

• Type: Integer
• Description: Count of sample records included for this sensor.

samples

• Type: Array
• Description: List of individual sensor sample records.

created_at

• Type: Integer
• Description: Sample creation timestamp in Unix epoch seconds.

temperature_deg_c

• Type: Number
• Description: Temperature reading in degrees Celsius at sample time.

humidity_pct

• Type: Number
• Description: Relative humidity percentage at sample time.

sampled_at_location

• Type: Object
• Description: Location details captured with the sample.

address

• Type: String
• Description: Human-readable address for the sample location.

lat

• Type: Number
• Description: Latitude of the sample location.

lon

• Type: Number
• Description: Longitude of the sample location.