GET /v2/telemetry

Request

# All customer devices
curl -k "https://api.illumience.com:11443/v2/telemetry?from=1709251200&to=1709337600&limit=100" \
  -H "Authorization: Bearer <api_key>"

# Specific devices only
curl -k "https://api.illumience.com:11443/v2/telemetry?from=1709251200&to=1709337600&device_ids=66e0b123c0d7400c7d909dba,66e0b456c0d7400c7d909dbb" \
  -H "Authorization: Bearer <api_key>"

Query Parameters

Parameter	Required	Type	Default	Description
from	Yes	integer	—	Start time as Unix timestamp (seconds)
to	Yes	integer	—	End time as Unix timestamp (seconds)
limit	No	integer	1000	Max records per device (1 - 10,000)
device_ids	No	string	—	Comma-separated MongoDB ObjectId hex strings
next_cursor	No	float	—	Pagination cursor (applies to all devices)

Constraints

• Same time range validation as the single-device endpoint

• Maximum 20 devices per request

• If device_ids is omitted, all customer devices are queried (fails with 400 if the customer has more than 20 devices)

Response 200 OK

{
  "devices": [
    {
      "device_id": 4521,
      "total": 50,
      "has_more": false,
      "next_cursor": null,
      "pings": [ ... ]
    },
    {
      "device_id": 4522,
      "total": 30,
      "has_more": true,
      "next_cursor": 1709308801.0,
      "pings": [ ... ]
    }
  ]
}

Response Fields

Field	Type	Description
devices	array	List of per-device telemetry results

Per-Device Object:

Field	Type	Description
device_id	integer	Numeric device identifier
total	integer	Number of pings returned for this device
has_more	boolean	Whether more records exist for this device
next_cursor	float or null	Pagination cursor for this device
pings	array	Ping objects (same format as single-device endpoint)

Errors

Code	Cause
400	Missing from/to, invalid range, too many devices, invalid ObjectId in device_ids