List network graph nodes
LogsGET /topology/nodes
Lists the network assets that are topology nodes in the tenant, newest first, with cursor pagination (limit defaults to 20, maximum 100). Assets that are not part of the topology are left out. Filters combine with AND and requires network read access.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
node_typeReturns only nodes of this type: source_river, source_borehole, treatment_plant, reservoir, dma_inlet, junction or customer_tap.
one of
source_river,source_borehole,treatment_plant,reservoir,dma_inlet,junction,customer_tapservice_area_idReturns only nodes assigned to this service area ID; an exact match.
dma_idReturns only nodes that belong to this district metered area ID; an exact match.
qFree-text search matched as a substring against the node's name or code.
Returns
200 Nodes
Show attributes
dataShow child attributes
idtenant_idnode_codenamenode_typeone of
source_river,source_borehole,treatment_plant,reservoir,dma_inlet,junction,customer_tapelevation_metersstorage_capacity_m3latitudelongitudeactiveservice_area_iddma_iddevice_idLevel or flow device reporting measurements
meter_idCustomer meter attributed to a customer_tap
meter_serialSerial number of the referenced meter. Omitted when unknown.
meter_holder_nameDisplay name of the customer who holds the account the meter is installed on. Omitted when unknown.
created_atupdated_at
has_morenext_cursor
Permissions network:read · Roles: admin, analyst, field_reader, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/topology/nodes" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/topology/nodes", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/topology/nodes",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/topology/nodes", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "top_20EbJqgt7ECLvqS5fuUZFei3bys",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"node_code": "NOD-2026-000142",
"name": "Ana Matsinhe",
"node_type": "source_river",
"elevation_meters": 1,
"storage_capacity_m3": 1,
"latitude": -25.9653,
"longitude": 32.5892,
"active": true,
"service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
"dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
"device_id": "dev_2E2J9iiRr2o7PWMrj8wJrQyb9sK",
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"meter_serial": "meter serial",
"meter_holder_name": "Ana Matsinhe",
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}