HomeGuidesAPI ReferenceChangelog
Log In
API Reference

List Lookup Values

Return lookup table values for a LOOKUP Property Key.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Use this endpoint to return lookup table values for a LOOKUP Property Key.

When to use this endpoint

Use GET /rest/public/properties/{propertyKey}/lookups when you need to:

  • Query values for a Property Key with dataType set to LOOKUP.
  • Retrieve lookup values for a specific date range.
  • Filter lookup values by sub-property when the Property Key has choices such as zones or nodes.
  • Access values that may change frequently over time, such as market price indexes or variable rate values.

Path parameter

ParameterTypeDescription
propertyKeyStringProperty Key name whose lookup values you want to retrieve.

Optional filters

ParameterTypeDescription
subPropertyKeyStringSub-property key name when the lookup values are divided by sub-property.
fromDateTimeDateTimeStarting date and time for returned lookup values.
toDateTimeDateTimeEnding date and time for returned lookup values.
triangle-exclamation

Use fromDateTime with toDateTime to avoid edge cases where an empty results array is returned. When neither value is passed, the default behavior is to return 72 hours of data entries at the lookup's cadence.

Related endpoints

Path Params
string
required
Query Params
string

Property key name

string

Subproperty key name

date

Date range - from value

date

Date range - to value

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json