====IncludeMetadata====

The **objects/value** endpoint supports the non-standard **includeMetadata** parameter in [[i3x:Welcome|i3X]].

This returns additional value metadata in the response to the value call, such as units-of-measurement, range, value-to-string mappings and suggested number of decimal places.

This option is //only available for the value function// and is not available in subscriptions or the history function.

It changes your returned values from this...

<code javascript>
"value": "34.50252809821145",
</code>

to this...

<code javascript>
"value": {
   "type": "decimal",
   "decimals": "1",
   "max": "100",
   "min": "0",
   "engUnit": "%",
   "value": "34.66807978850546"
},
</code>

This parameter can be combined with [[includeParents]] and can be made permanent by adjusting the settings for the addon.