Asset Groups

Asset groups define higher level groupings of assets within the Validere Platform.

https://api.validere.io/app

Search asset groups

Search and list Asset Groups

post

Authorizations

StagingIntegrationLocal

Body

application/json

and

and

Responses

200

Successfully something

application/json

post

/app/v1/asset_groups/search

HTTPcURLJavaScriptPython

POST /app/v1/asset_groups/search HTTP/1.1
Host: api.validere.io
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "page": 0,
  "page_size": 20,
  "sort_by": "name",
  "sort_direction": "desc",
  "filter": {
    "$or": [
      {
        "asset.asset_type": "equipment"
      },
      {
        "name": {
          "$like": "Asset Group 1"
        }
      }
    ]
  }
}

200

Successfully something

{
  "page_number": 0,
  "page_size": 10,
  "total_entries": 58,
  "total_pages": 6,
  "data": [
    {
      "name": "text",
      "status": "active",
      "asset_group_type_id": "network",
      "default_network_reporting_group_id": "text",
      "default_network_reporting_group": {
        "name": "SubpartW",
        "description": "my reporting group",
        "priority": 2,
        "id": "subpartw"
      },
      "default_estimation_method_id": "123e4567-e89b-12d3-a456-426614174000",
      "default_estimation_method": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "company_id": "123e4567-e89b-12d3-a456-426614174000",
        "asset_id": "123e4567-e89b-12d3-a456-426614174000",
        "analytics_library_id": "2024-SubpartW",
        "analytics_calculator_id": "2024-SubpartW-AcidGasRemovalMethod1",
        "name": "SubpartW AGR Method",
        "status": "active",
        "default_values": {
          "fuel_type": {
            "value": "Eastern",
            "unit": "",
            "measurement_type": "measurement_type",
            "measurement_quantity": "dimensionless_coefficient"
          },
          "volume": {
            "value": 5,
            "unit": "e3m3",
            "measurement_type": "measurement_type",
            "measurement_quantity": "volume"
          }
        },
        "default_asset_values": {
          "a04b4387-5145-4935-9edc-d53ecdb7a6c0": {
            "fuel_type": {
              "value": "Eastern",
              "unit": "",
              "measurement_type": "measurement_type",
              "measurement_quantity": "dimensionless_coefficient"
            },
            "volume": {
              "value": 5,
              "unit": "e3m3",
              "measurement_type": "measurement_type",
              "measurement_quantity": "volume"
            }
          },
          "99a45dd3-6ce1-4290-9d16-79415111cc43": {
            "fuel_type": {
              "value": "Eastern",
              "unit": "",
              "measurement_type": "measurement_type",
              "measurement_quantity": "dimensionless_coefficient"
            },
            "volume": {
              "value": 5,
              "unit": "e3m3",
              "measurement_type": "measurement_type",
              "measurement_quantity": "volume"
            }
          }
        },
        "created_at": "2026-01-26T13:55:44.542Z",
        "updated_at": "2026-01-26T13:55:44.542Z",
        "created_by": "123e4567-e89b-12d3-a456-426614174000",
        "updated_by": "123e4567-e89b-12d3-a456-426614174000"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "company_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-01-26T13:55:44.542Z",
      "created_by": "123e4567-e89b-12d3-a456-426614174000",
      "updated_at": "2026-01-26T13:55:44.542Z",
      "updated_by": "123e4567-e89b-12d3-a456-426614174000",
      "custom_attributes": {
        "attribute1": 12345,
        "attribute2": "value1"
      },
      "assets": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_type": "equipment"
        }
      ],
      "network_inlet_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ]
}

Get an asset group

Get an asset group

get

Authorizations

StagingIntegrationLocal

Path parameters

idstring · uuidRequired

Asset Group ID

Query parameters

periodstringOptional

year month (YYYYMM), defaulting to the current time, indicates which time period to return the attributes and custom attributes from

Responses

200

A successful operation

application/json

get

/app/v1/asset_groups/{id}

HTTPcURLJavaScriptPython

GET /app/v1/asset_groups/{id} HTTP/1.1
Host: api.validere.io
Accept: */*

200

A successful operation

{
  "name": "text",
  "status": "active",
  "asset_group_type_id": "network",
  "default_network_reporting_group_id": "text",
  "default_network_reporting_group": {
    "name": "SubpartW",
    "description": "my reporting group",
    "priority": 2,
    "id": "subpartw"
  },
  "default_estimation_method_id": "123e4567-e89b-12d3-a456-426614174000",
  "default_estimation_method": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "company_id": "123e4567-e89b-12d3-a456-426614174000",
    "asset_id": "123e4567-e89b-12d3-a456-426614174000",
    "analytics_library_id": "2024-SubpartW",
    "analytics_calculator_id": "2024-SubpartW-AcidGasRemovalMethod1",
    "name": "SubpartW AGR Method",
    "status": "active",
    "default_values": {
      "fuel_type": {
        "value": "Eastern",
        "unit": "",
        "measurement_type": "measurement_type",
        "measurement_quantity": "dimensionless_coefficient"
      },
      "volume": {
        "value": 5,
        "unit": "e3m3",
        "measurement_type": "measurement_type",
        "measurement_quantity": "volume"
      }
    },
    "default_asset_values": {
      "a04b4387-5145-4935-9edc-d53ecdb7a6c0": {
        "fuel_type": {
          "value": "Eastern",
          "unit": "",
          "measurement_type": "measurement_type",
          "measurement_quantity": "dimensionless_coefficient"
        },
        "volume": {
          "value": 5,
          "unit": "e3m3",
          "measurement_type": "measurement_type",
          "measurement_quantity": "volume"
        }
      },
      "99a45dd3-6ce1-4290-9d16-79415111cc43": {
        "fuel_type": {
          "value": "Eastern",
          "unit": "",
          "measurement_type": "measurement_type",
          "measurement_quantity": "dimensionless_coefficient"
        },
        "volume": {
          "value": 5,
          "unit": "e3m3",
          "measurement_type": "measurement_type",
          "measurement_quantity": "volume"
        }
      }
    },
    "created_at": "2026-01-26T13:55:44.542Z",
    "updated_at": "2026-01-26T13:55:44.542Z",
    "created_by": "123e4567-e89b-12d3-a456-426614174000",
    "updated_by": "123e4567-e89b-12d3-a456-426614174000"
  },
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "company_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-01-26T13:55:44.542Z",
  "created_by": "123e4567-e89b-12d3-a456-426614174000",
  "updated_at": "2026-01-26T13:55:44.542Z",
  "updated_by": "123e4567-e89b-12d3-a456-426614174000",
  "custom_attributes": {
    "attribute1": 12345,
    "attribute2": "value1"
  },
  "assets": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_type": "equipment"
    }
  ],
  "network_inlet_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}