Skip to content
Teleport

Listing devices

Retrieve a list of all devices in your organization. This route is rate limited to 10 requests per 5 minutes per API key. It uses pagination with 100 results per page.


REQUEST
method + URL
GET https://api.teleport.withthegrid.com/v1/device/
query string (in TS)
{
offset?: string;
}
query string details
offset?
Is used for pagination, see https://teleport.withthegrid.com/api/#pagination
RESPONSE
successful responses
200
List of devices
body for status 200 (in TS)
{
devices: {
hashId: string;
name: string;
cloudApi: "READ" | "READ_WRITE";
reportingInterval: number;
dataForwarding: boolean;
assets: {
type: string;
identifier: string;
}[];
}[];
}
details for body status 200 (in TS)
devices[].cloudApi
"READ" means that the device is visible in the Teleport Cloud API, but requests to schedule asset commands or setting asset parameters for them will be rejected. "READ_WRITE" means that scheduling asset commands and setting asset parameters is allowed.
devices[].reportingInterval
In seconds. Applies to the default report type of each asset, like "solarPower", "windPower" and "batteryPower". Does not apply to auxilary reports like "batteryPower.flash".
devices[].dataForwarding
Whether data forwarding is enabled for this device. See https://teleport.withthegrid.com/data-forwarding/ for more information.
devices[].schedule
The latest schedule sent in through our cloud API confirmed by this device. Instructions coming from control loops or the local API are not included.
error responses (next to generic errors)
400 { key: "invalid_offset" }
The provided offset query parameter is invalid