Retrieve Measurement Data

This endpoint allows you to fetch measurement data recorded during shipment. For non-real-time devices, measurement data is only available after shipment completion.

Note: Measurement data can be retrieved for a maximum period of 5 days.

Request

---

GET https://openapi.willog.io/ext/v2/devices/{serial}/measurements

Path Variable

Name	Description
serial	Device serial code

Query Parameters

Name	Type	Required	Description
startAt	Unix timestamp(ms)	true	Start time for data retrieval
endAt	Unix timestamp(ms)	true	End time for data retrieval
customerCode	String	false	Customer code
measurementTypes	Array	true	Types of measurements to retrieve

Measurement Types

Name	Description
TEMPERATURE	Temperature
HUMIDITY	Humidity
ACC	Acceleration
ACCX	Acceleration X-axis
ACCY	Acceleration Y-axis
ACCZ	Acceleration Z-axis
TILTX	Tilt X-axis
TILTY	Tilt Y-axis
TILTZ	Tilt Z-axis
EXP	Light Exposure(Lux)

Example Request

GET /ext/v2/devices/{serial}/measurements?startAt=1738655274000&endAt=1738655274000&measurementTypes=TEMPERATURE&measurementTypes=HUMIDITY
Authorization: Bearer token

Response

---

Response Body

Name	Type	Not-null	Description
items	Array	true	List of measurements
time	Unix timestamp(ms)	true	Measurement time
temperature	Number	false	Temperature value
humidity	Number	false	Humidity value
acc	Number	false	Acceleration value
accx	Number	false	Acceleration X-axis
accy	Number	false	Acceleration Y-axis
accz	Number	false	Acceleration Z-axis
tiltx	Number	false	Tilt X-axis
tilty	Number	false	Tilt Y-axis
tiltz	Number	false	Tilt Z-axis

Example Response

HTTP/1.1 200 OK

{
  "items": [
    {
      "time": 1738655274000,
      "temperature": 36.5,
      "humidity": 56
    }
  ]
}

Error Responses

- Unauthorized Access to Customer Data

HTTP/1.1 400 Bad Request

{
  "code": "A0016"
}

- Unregistered Device

HTTP/1.1 400 Bad Request

{
  "code": "T0007"
}

- Invalid Date Range

HTTP/1.1 400 Bad Request

{
  "code": "E0004"
}