Skip to content
  • There are no suggestions because the search field is empty.

API Reference: Device Reports

A Device Report returns the temperature history of a device for a given time period.

Timestamp:
  • Last reported timestamp of the device.
  • Reported in seconds since unix epoch (multiply by 1000 for milliseconds).
  • As most devices report to the cloud every 15 minutes, an offline device is generally considered to have a timestamp of 31 minutes ago.
Temperature:
  • Temperature as reported by the device.
  • Reported in °C
  • For devices with removable / interchangeable temperature sensors (ICE Coolers, for example), a null temperature value indicates the icepack has been removed. For all other devices this indicates a sensor read error.

/devices/report/<DEVICE_TYPE>/<SERIAL_NUMBER>

HTTPS GET Output JSON BloodCOMM PRO BloodCOMM PREMIUM

Get the temperature record of a single device. A valid license for this device is required.

Note: This endpoint will default to returning the past 7 days of data, however up to a year's worth of history is available. Use query parameters to adjust the date range.`

Method Description Response
GET Returns a single device's temperature record JSON Object

Response:

Method Description Units
timestamp Timestamp of recorded Temperature seconds
temperature Current Cooler Temperature °C

Query Parameters:

Method Description Units Required Default
start Initial timestamp to query (oldest) seconds false 7 days ago
end Final timestamp to query (newest) seconds false today

For example:
/devices/report/APRU-006L/0001234?start=1747379847&end=1747379849

[
  {
    "timestamp": <int>,
    "temperature": <float>,
  },
  {
    "timestamp": <int>,
    "temperature": <float>,
  },
  {
    "timestamp": <int>,
    "temperature": <float>,
  },
  ...
]