List telemetry sensors
LogsGET /sensors
Returns a cursor-paginated page of the tenant's telemetry sensors, each with its code, device ID, metric, unit, location in the supply chain and linked asset or DMA. Page with limit and after. Requires the monitoring read permission.
Parameters
kindReturns only sensors of this kind: flow, pressure, level or quality.
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Returns
200 OK
Show attributes
dataShow child attributes
idcodenamedevice_idkindone of
flow,pressure,level,qualitymetricunitlocationone of
abstraction_point,treatment_plant,reservoir,distributionasset_iddma_idactive
has_morenext_cursor
Permissions business:monitoring:read · Roles: admin, analyst, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/sensors" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/sensors", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/sensors",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/sensors", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "sen_28o3p46TDQsRdq8pzycV5cIxbMg",
"code": "COD-2026-000142",
"name": "Ana Matsinhe",
"device_id": "dev_2E2J9iiRr2o7PWMrj8wJrQyb9sK",
"kind": "flow",
"metric": "metric",
"unit": "unit",
"location": "abstraction_point",
"asset_id": "ass_2IIXBYi79uuRV0QXd685rmSLhO0",
"dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
"active": true
}
],
"has_more": true,
"next_cursor": "next cursor"
}