Temperature Report

Temperature sensor readings from vehicle-mounted hardware. Track cold chain compliance and detect excursions.

GET/apidev/v1/reports/avl/temperature

PermissionAPICLI_RPTAVL_TEMPERATURA

Rate Limit10 req/min (sliding window)

Cache300s (5 min)

Max Range31 days

---

Overview

Returns temperature sensor readings from vehicles equipped with onboard temperature monitoring. Critical for cold chain logistics, pharmaceutical transport, and food delivery compliance.

• Raw readings — individual data points with timestamps
• Daily aggregation — perday=true for aggregated values per day
• Subtotals — subtotals=true for summary rows

info

Only vehicles with a temperature sensor configured return data. Devices without sensors are silently excluded.

---

Query Parameters

Parameter	Type	Required	Default	Description
startdate	string	Yes	—	ISO 8601 start date-time
enddate	string	Yes	—	ISO 8601 end date-time. Max range 31 days
devices	string	No	All visible	Comma-separated device IDs. Max 500
perday	boolean	No	false	Aggregate readings by day
subtotals	boolean	No	false	Include subtotal rows
limit	integer	No	25	Records per page (1–100)
offset	integer	No	0	Records to skip

---

Code Examples

cURL

curl -s "https://$TENANT/apidev/v1/reports/avl/temperature?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&limit=50&perday=true" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT"

JavaScript

const response = await fetch(
  `https://${TENANT}/apidev/v1/reports/avl/temperature?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&limit=50&perday=true`,
  { headers }
);
const { data, meta } = await response.json();

Python

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/avl/temperature",
    headers=headers,
    params={
        "startdate": "2026-03-01T00:00:00",
        "enddate": "2026-03-15T23:59:59",
        "limit": 50,
        "perday": True,
    },
)
result = response.json()

---

Response Fields

Field	Type	Description
device_name	string	Display name of the vehicle/device
device_group	string	Group the device belongs to
datetime	string | null	Timestamp of the reading, or date when perday is enabled
temperature	number	Temperature reading in °C (sensor 1)

tip

Temperature values are in degrees Celsius. Convert client-side if needed: F = (C × 9/5) + 32.

Example Response

{
  "success": true,
  "data": [
    {
      "device_name": "Reefer R-401",
      "device_group": "Cold Chain Fleet",
      "datetime": "2026-03-05",
      "temperature": -2.4
    },
    {
      "device_name": "Reefer R-401",
      "device_group": "Cold Chain Fleet",
      "datetime": "2026-03-06",
      "temperature": -1.8
    }
  ],
  "meta": {
    "total": 14,
    "limit": 50,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
BAD_REQUEST	400	Missing required headers
VALIDATION_ERROR	400	Invalid params: missing dates, range > 31 days
UNAUTHORIZED	401	Invalid or expired JWT / API Key
FORBIDDEN	403	User lacks APICLI_RPTAVL_TEMPERATURA permission
RATE_LIMITED	429	Exceeded 10 req/min
INTERNAL_ERROR	500	Unexpected server error

---

Related

• Ignition Report — Includes temperature_1 and temperature_2 per ignition period
• Pagination — Standard pagination parameters