Unit Types – G17Eco

Units & Conversions

The G17Eco API supports a comprehensive set of measurement units for tracking sustainability metrics. This page documents all available unit types, their options, and conversion factors.

Supported Unit Types

The API supports the following categories of measurement units through the unitType field:

Unit Type	Enum Value	Purpose	Default Unit
Area	`area`	Land use, facility size	`km2`
Length	`length`	Distance measurements	`km`
Mass	`mass`	Weight and material quantities	`mt` (metric tons)
Volume	`volume`	Liquid and gas quantities	`m3`
Time	`time`	Duration tracking	`h` (hours)
Energy	`energy`	Power consumption and generation	`MWh`
CO2 Emissions	`co2Emissions`	Greenhouse gas emissions	`tons/CO2e`
Parts Per	`partsPer`	Concentration measurements	`ppm`
Number Scale	`numberScale`	Large number representation	`millions`

Interactive Unit Converter

Unit Converter

Unit Type:

Understanding Unit Configuration

Universal Trackers have predefined unit configurations that determine how values should be submitted. When you retrieve a Universal Tracker through the API, it includes:

{
  "universalTracker": {
    "_id": "507f1f77bcf86cd799439011",
    "name": "Annual Energy Consumption",
    "valueType": "number",
    "unitType": "energy",
    "unit": "MWh",
    "numberScale": "thousands",
    "valueValidation": {
      "min": 0,
      "max": 999999,
      "decimal": 2
    }
  }
}

This configuration tells you:

Values should be submitted in Megawatt hours (MWh)
Numbers are in thousands (e.g., submitting 1.5 = 1,500 MWh)
Maximum 2 decimal places allowed
Valid range: 0 to 999,999,000 MWh (after scale conversion)

Input Values Error