Listar nós da rede
RegistosGET /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.
Parâmetros
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.
um de
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.
Devolve
200 Nodes
Mostrar atributos
dataMostrar atributos filhos
idtenant_idnode_codenamenode_typeum de
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
Permissões network:read · Funções: admin, analyst, field_reader, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/topology/nodes" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
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"
}