GET /api/v3/placeBenchmark/{benchmarkIndicator}/place/{placeId}/benchmarkValue

Retrieves all benchmark values for a specific benchmark indicator on a place

GetBenchmarkValuesV3 Permissions: BuildingsAndOrganizations (View)

Use this endpoint to get the time-series history of a benchmark on a place. Returns the benchmark name, category, and all value records with begin/end dates.

Request Headers

Header	Value	Required	Description
ECI-ApiKey	string	Yes	Your API key. See Authentication.
Content-Type	application/json	Yes	All requests must specify JSON content type.

Path Parameters

Name	Description	Type	Required
benchmarkIndicator	Benchmark slot identifier (1, 2, or 3)	integer (int32)	Required
placeId	Unique numeric identifier of the place (must be a structure/site)	integer (int32)	Required

Responses

200 OK The request succeeded and the response body contains the requested data.

Response Body Parameters

BenchmarkValuesResponse

Property

Description

Type

benchmarkCategory

BenchmarkCategoryResponse

BenchmarkCategoryResponse properties

Property	Description	Type
benchmarkCategoryId	Benchmark Category Id	integer (int32)
benchmarkCategoryInfo	Benchmark Category Info	string

benchmarkIndicator

Indicator for which benchmark factor Required (defined)

integer (int32)

benchmarkInfo

benchmark info Required (defined)

string

benchmarkValues

List of benchmark values and their effective dates Required (defined)

BenchmarkValue[]

BenchmarkValue properties

Property	Description	Type
benchmarkValueId	Indicator for which benchmark factor Required (defined)	integer (int32)
effectiveDate	Effective Date for the benchmark factor Required (defined)	string (date-time)
endDate	End Date for the benchmark factor Required (defined)	string (date-time)
value	Value set for the benchmark factor Required (defined)	number (double)

Example Response application/json

{  "benchmarkCategory": {    "benchmarkCategoryId": 1,    "benchmarkCategoryInfo": "string"
  },  "benchmarkIndicator": 1,  "benchmarkInfo": "string",  "benchmarkValues": [
    {    "benchmarkValueId": 1,    "effectiveDate": "2026-06-29",    "endDate": "2026-06-29",    "value": 1.0
  }
  ]
}