DeviceList
devices object[]required
Record identifier. Always equal to imei.
15-digit IMEI.
Possible values: >= 15 characters and <= 15 characters, Value must match regular expression ^\d{15}$
123456789012345Possible values: [pending, active, inactive, decommissioned]
Absent until a business unit is assigned.
Possible values: [addv-prod, lfc-preprod, lfc-prod]
addv-prodSelects the downstream sink where this device's incoming telemetry is delivered. The value is not restricted to a fixed list; each business unit uses labels that map to routing in the data platform.
- Example 1
- Example 2
- Example 3
prodpreprodstagingARN of the IoT Thing. Set by Fleet Provisioning; absent while pending.
arn:aws:iot:eu-west-1:123456789012:thing/123456789012345Also used as an optimistic lock; concurrent writes return 409.
Set by Fleet Provisioning; absent while pending.
Present when more results exist. Pass it back as the nextToken query parameter.
{
"devices": [
{
"id": "123456789012345",
"imei": "123456789012345",
"provisioningStatus": "active",
"businessUnit": "addv-prod",
"environment": "prod",
"thingArn": "arn:aws:iot:eu-west-1:123456789012:thing/123456789012345",
"createdAt": "2026-03-02T09:15:00.000Z",
"updatedAt": "2026-03-04T11:20:31.000Z",
"provisionedAt": "2026-03-04T11:20:31.000Z"
}
],
"nextToken": "string"
}