Retrieve Device Readings

Route

GET /api/public/v0/devices/:deviceId/data

Path Parameters

Parameter	Type	Required	Description
deviceId	string	Yes	The unique identifier (DevEUI) of the device.

Query Parameters

• limit: Maximum number of readings to return. Optional, defaults to no limit.
• start: ISO date-time string specifying the lower limit of the date-time range for the returned sensor data. Optional, defaults to no lower bound.
• end: ISO date-time string specifying the upper limit of the date-time range for the returned sensor data. Optional, defaults to no upper bound.

Response

The data returned will always ordered chronologically in descending order (most recent first). Information about the device is not included in the response.

Schema

[
  {
    createdAt: string;
    temperature: number | null;
    humidity: number | null;
    rain: number | null;
  }
]

Example

[
  {
    "createdAt": "2023-07-31T03:31:00.114Z",
    "temperature": 10.254,
    "humidity": 120,
    "rain": 199
  }
  // ... 9 more readings
]

Response Codes

Code	Description
500	Internal server error
400	Invalid or missing parameters