Assets

Base URL: $BUSINESS_API

The object

idstring · required
tenant_idstring · required
codestring · required
namestring · required
asset_typestring · required

one of source, treatment_plant, reservoir, pump_station, pipe, valve, hydrant, dma, junction, customer_tap

service_area_idstring · optional
statusstring · required

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional
node_typestring · optional

one of source_river, source_borehole, treatment_plant, reservoir, dma_inlet, junction, customer_tap

storage_capacity_m3integer (int64) · optional
dma_idstring · optional
device_idstring · optional
meter_idstring · optional
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

created_atstring (date-time) · required
updated_atstring (date-time) · required
The object
{
  "id": "net_2VvwojxMyhpssxfSu15amL5GsjX",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "code": "COD-2026-000142",
  "name": "Ana Matsinhe",
  "asset_type": "source",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "status": "operational",
  "capacity": 1,
  "latitude": -25.9653,
  "longitude": 32.5892,
  "elevation": 1,
  "installation_date": "2026-11-19T09:30:00Z",
  "properties": {},
  "node_type": "source_river",
  "storage_capacity_m3": 1,
  "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"
}

List water network assets

Logs

GET /assets

Returns the tenant's water network assets with cursor pagination (limit defaults to 20, at most 100). Filter by asset_type, status or service_area_id, and use q to match a substring of the asset name or code. Requires network:read.

Parameters

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

Returns

200 Network assets

Show attributes
dataarray of NetworkAsset · required
Show child attributes
idstring · required
tenant_idstring · required
codestring · required
namestring · required
asset_typestring · required

one of source, treatment_plant, reservoir, pump_station, pipe, valve, hydrant, dma, junction, customer_tap

service_area_idstring · optional
statusstring · required

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional
node_typestring · optional

one of source_river, source_borehole, treatment_plant, reservoir, dma_inlet, junction, customer_tap

storage_capacity_m3integer (int64) · optional
dma_idstring · optional
device_idstring · optional
meter_idstring · optional
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

created_atstring (date-time) · required
updated_atstring (date-time) · required
has_moreboolean · required
next_cursorstring · optional
total_countinteger · optional

Permissions network:read · Roles: admin, analyst, field_reader, field_supervisor, operations, owner, viewer

curl -X GET "$BUSINESS_API/assets" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "data": [
    {
      "id": "net_2VvwojxMyhpssxfSu15amL5GsjX",
      "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
      "code": "COD-2026-000142",
      "name": "Ana Matsinhe",
      "asset_type": "source",
      "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
      "status": "operational",
      "capacity": 1,
      "latitude": -25.9653,
      "longitude": 32.5892,
      "elevation": 1,
      "installation_date": "2026-11-19T09:30:00Z",
      "properties": {},
      "node_type": "source_river",
      "storage_capacity_m3": 1,
      "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",
  "total_count": 125000
}

Register a water network asset

Logs

POST /assets

Registers a network asset such as a reservoir, pump station, pipe, valve or hydrant. code, name and asset_type are required, and status defaults to operational. The code must be unique within the tenant: a duplicate answers 409. Requires network:write and returns 201 with the stored asset.

Body application/json

codestring · required
namestring · required
asset_typestring · required

one of source, treatment_plant, reservoir, pump_station, pipe, valve, hydrant, dma, junction, customer_tap

service_area_idstring · optional
statusstring · optional

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional

Returns

201 Network asset registered

Show attributes
idstring · required
tenant_idstring · required
codestring · required
namestring · required
asset_typestring · required

one of source, treatment_plant, reservoir, pump_station, pipe, valve, hydrant, dma, junction, customer_tap

service_area_idstring · optional
statusstring · required

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional
node_typestring · optional

one of source_river, source_borehole, treatment_plant, reservoir, dma_inlet, junction, customer_tap

storage_capacity_m3integer (int64) · optional
dma_idstring · optional
device_idstring · optional
meter_idstring · optional
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

created_atstring (date-time) · required
updated_atstring (date-time) · required

Permissions network:write · Roles: admin, operations, owner

curl -X POST "$BUSINESS_API/assets" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "code": "COD-2026-000142",
  "name": "Ana Matsinhe",
  "asset_type": "source",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "status": "operational",
  "capacity": 1,
  "latitude": -25.9653,
  "longitude": 32.5892,
  "elevation": 1,
  "installation_date": "2026-11-19T09:30:00Z",
  "properties": {}
}'
Response 201
{
  "id": "net_2VvwojxMyhpssxfSu15amL5GsjX",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "code": "COD-2026-000142",
  "name": "Ana Matsinhe",
  "asset_type": "source",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "status": "operational",
  "capacity": 1,
  "latitude": -25.9653,
  "longitude": 32.5892,
  "elevation": 1,
  "installation_date": "2026-11-19T09:30:00Z",
  "properties": {},
  "node_type": "source_river",
  "storage_capacity_m3": 1,
  "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"
}

Get network asset details

Logs

GET /assets/{id}

Returns one network asset with its type, status, service area, capacity, coordinates, elevation, installation date and free-form properties. Answers 404 when the asset is not in the caller's tenant. Requires network:read.

Parameters

idstring · path · required

Identifier of the network asset (prefix ast_).

Returns

200 Network asset details

Show attributes
idstring · required
tenant_idstring · required
codestring · required
namestring · required
asset_typestring · required

one of source, treatment_plant, reservoir, pump_station, pipe, valve, hydrant, dma, junction, customer_tap

service_area_idstring · optional
statusstring · required

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional
node_typestring · optional

one of source_river, source_borehole, treatment_plant, reservoir, dma_inlet, junction, customer_tap

storage_capacity_m3integer (int64) · optional
dma_idstring · optional
device_idstring · optional
meter_idstring · optional
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

created_atstring (date-time) · required
updated_atstring (date-time) · required

Permissions network:read · Roles: admin, analyst, field_reader, field_supervisor, operations, owner, viewer

curl -X GET "$BUSINESS_API/assets/{id}" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "id": "net_2VvwojxMyhpssxfSu15amL5GsjX",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "code": "COD-2026-000142",
  "name": "Ana Matsinhe",
  "asset_type": "source",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "status": "operational",
  "capacity": 1,
  "latitude": -25.9653,
  "longitude": 32.5892,
  "elevation": 1,
  "installation_date": "2026-11-19T09:30:00Z",
  "properties": {},
  "node_type": "source_river",
  "storage_capacity_m3": 1,
  "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"
}

Update a water network asset

Logs

PUT /assets/{id}

Changes only the fields you send: name, status, capacity, latitude, longitude, elevation, installation_date and properties. Empty strings and zero numbers are treated as not sent, so this call cannot clear a field or set a coordinate to exactly 0, and properties is replaced as a whole when present. Code, type and service area cannot be changed here. Requires network:write; 404 when the asset is not in the tenant.

Parameters

idstring · path · required

Identifier of the network asset to update (prefix ast_).

Body application/json

namestring · optional
statusstring · optional

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional

Returns

200 Network asset updated

Show attributes
idstring · required
tenant_idstring · required
codestring · required
namestring · required
asset_typestring · required

one of source, treatment_plant, reservoir, pump_station, pipe, valve, hydrant, dma, junction, customer_tap

service_area_idstring · optional
statusstring · required

one of operational, maintenance, offline, decommissioned

capacitynumber · optional
latitudenumber · optional
longitudenumber · optional
elevationnumber · optional
installation_datestring (date-time) · optional
propertiesobject · optional
node_typestring · optional

one of source_river, source_borehole, treatment_plant, reservoir, dma_inlet, junction, customer_tap

storage_capacity_m3integer (int64) · optional
dma_idstring · optional
device_idstring · optional
meter_idstring · optional
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

created_atstring (date-time) · required
updated_atstring (date-time) · required

Permissions network:write · Roles: admin, operations, owner

curl -X PUT "$BUSINESS_API/assets/{id}" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ana Matsinhe",
  "status": "operational",
  "capacity": 1,
  "latitude": -25.9653,
  "longitude": 32.5892,
  "elevation": 1,
  "installation_date": "2026-11-19T09:30:00Z",
  "properties": {}
}'
Response 200
{
  "id": "net_2VvwojxMyhpssxfSu15amL5GsjX",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "code": "COD-2026-000142",
  "name": "Ana Matsinhe",
  "asset_type": "source",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "status": "operational",
  "capacity": 1,
  "latitude": -25.9653,
  "longitude": 32.5892,
  "elevation": 1,
  "installation_date": "2026-11-19T09:30:00Z",
  "properties": {},
  "node_type": "source_river",
  "storage_capacity_m3": 1,
  "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"
}