HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Get Properties

Return a full or filtered list of Properties.

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

Retrieve a full or filtered list of property keys.

Use this endpoint to find metadata keys used by tariffs, calculations, applicability rules, and lookup-backed values. You can filter by data type, family, keyspace, or entity-specific ownership.

Resource URI

GET /rest/public/properties

Query parameters

ParameterTypeDescription
dataTypeStringReturn only properties with this data type, such as STRING, CHOICE, BOOLEAN, DATE, DECIMAL, INTEGER, FORMULA, LOOKUP, or DEMAND. Optional.
familyStringReturn properties in a family, such as billing, metering, or connection. Optional.
keySpaceStringReturn properties in a keyspace, such as electricity or solarPv. Optional.
entityIdLongReturn properties that belong to this entity ID. Requires entityType; otherwise ignored. Optional.
entityTypeStringReturn properties that belong to this entity type. Requires entityId; otherwise ignored. Currently supports LSE. Optional.
excludeGlobalBooleanWhen true, returns only entity-specific properties. Optional.

For the full PropertyKey data model and examples, see Properties.

Example

GET /rest/public/properties?dataType=LOOKUP&keySpace=market

A successful response returns a standard response payload with type set to PropertyKey and results containing matching property keys.

Query Params
string

Filters the result set to only include properties that have the specified dataType (Optional)

string

Filters the result by the family. Examples of family include "billing", "metering" and "connection". Look at the properties to see more examples of the family (Optional).

string

Filters the result by the key space. Possible values include "electricity" and "solarPv" (Optional)

int64

Filters the result set to only include properties that belong to this entityId. entityType must also be specified, otherwise this is ignored (Optional).

string

Filters the result set to only include properties that belong to this entityType. entityId must also be specified, otherwise this is ignored. Currently, the only supported value is "LSE" (Optional)

boolean

Filters the result set to only include entity-specific properties.

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