Get telemetry
GET/v1/telemetry
Retrieve telemetry records for a business unit within a time range. Returns newest records first. Requires IAM authentication via SigV4 with a valid business unit access role.
Permissions: The caller's IAM identity must be a valid access role (viewer, editor, or owner tier) for the requested business unit. Unauthorized access attempts return 403 Forbidden.
Rate limit: 500 RPS / 1000 burst.
Query parameters:
businessUnit(required): The business unit to query.from(required): Start time (ISO 8601).to(required): End time (ISO 8601). Time range must not exceed 7 days.imei(optional): Filter to a specific device IMEI.limit(optional, default 100, max 1000): Page size.nextToken(optional): Opaque pagination cursor from previous response.
Request
Responses
- 200
- 400
- 403
- 429
- 500
A page of telemetry records.
The request failed validation.
The request is not signed, or the signing principal lacks permission to call this operation.
Rate limit exceeded for this operation.
Unexpected failure.