Home › Library › Measurement Units

Measurement Units

Reference of measurement units for utility counters

Available Units

Code	Symbol	Name
`gb`	ГБ	Gigabyte
`kwh`	kWh	Kilowatt-hour
`m3`	m³	Cubic meter
`gcal`	Gcal	Gigacalorie
`liter`	L	Liter
`kg`	kg	Kilogram
`ton`	t	Ton
`pcs`	pcs	Piece
`mwh`	MWh	Megawatt-hour
`gj`	GJ	Gigajoule
`mbps`	Mbps	Megabit/s

Usage

Measurement units are used for counters to specify what is being measured. Each expense type has a default unit, but you can change it when creating a counter.

Examples

Electricity - kWh (Kilowatt-hour)
Water - m³ (Cubic meter)
Gas - m³ (Cubic meter)
Heating - Gcal (Gigacalorie)

REST API

Access measurement units via API

GET /api/v1/measurement-units
GET /api/v1/measurement-units/{code}

Example Response

{
  "measurement_units": [
    {
      "id": 1,
      "code": "kwh",
      "symbol": "kWh",
      "name": {
        "en": "kilowatt-hour",
        "uk": "кіловат-година",
        "ru": "киловатт-час",
        "pl": "kilowatogodzina"
      },
      "sort_order": 1
    },
    {
      "id": 2,
      "code": "m3",
      "symbol": "m³",
      "name": {
        "en": "cubic meter",
        "uk": "кубічний метр",
        "ru": "кубический метр",
        "pl": "metr sześcienny"
      },
      "sort_order": 2
    }
  ],
  "total": 10
}

Swagger / OpenAPI

Full API documentation is available in Swagger UI: /api/v1/doc