List network graph links
LogsGET /topology/links
Lists the directed links (pipes, mains and valves) of the tenant's network topology, newest first, with cursor pagination (limit defaults to 20, maximum 100). Filters combine with AND, and an unknown filter value returns an empty page rather than an error. Requires network read access.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
node_idMatches either endpoint
link_typeReturns only links of this type: gravity_main, pumping_main, distribution_pipe or control_valve.
one of
gravity_main,pumping_main,distribution_pipe,control_valvestatusReturns only links in this operating state: open, closed or throttled.
one of
open,closed,throttled
Returns
200 Links
Show attributes
dataShow child attributes
idtenant_idlink_codefrom_node_idto_node_idlink_typeone of
gravity_main,pumping_main,distribution_pipe,control_valvelength_metersdiameter_mmroughness_coefficientHazen-Williams C
statusone of
open,closed,throttledasset_idcreated_atupdated_at
has_morenext_cursor
Permissions network:read · Roles: admin, analyst, field_reader, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/topology/links" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/topology/links", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/topology/links",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/topology/links", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "top_26ATL6Y7Pm2ppeMTl60jhySNHae",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"link_code": "LIN-2026-000142",
"from_node_id": "fro_2b3GWtBsQPTMCF5SOjDUUp7QKHr",
"to_node_id": "ton_2qKn74u1zmYRZmiRFqqbFqoplME",
"link_type": "gravity_main",
"length_meters": 1,
"diameter_mm": 1,
"roughness_coefficient": 1,
"status": "open",
"asset_id": "ass_2IIXBYi79uuRV0QXd685rmSLhO0",
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}