Metering Values API

Metering Values API

The metering-values-api are currently used internally in BRS-NO-315 Query metering values for requesting historical metering values. The internal APIs will now also be exposed publicly, in order to provide the same data to the market through REST-APIs. The current SOAP-based BRS-NO-315 Query metering values will still be available as before, with the new REST-endpoints being available in parallel for a transition period. Before prod release the endpoints will be available in Market Trial (MT1) for testing and feedback.

Availability in test (MT1)

We are making the REST API for metering values available in MT1 so that market actors have sufficient time to test and give their feedback before go-live in production.

 

What can be tested

In MT1 we now expose two endpoints for fetching historic metering values:

  • GET /v2/{meteringPointId}/period-volume

  • GET /v2/{meteringPointId}/interval-volume

These endpoints will provide the same data as you currently get asynchronously as XML files in EMIF, in a synchronous REST-API and JSON:API response-format.

 

Rate limiting

Due to current internal bottlenecks, the performance of the new APIs is still limited. For this reason we will rate-limit the APIs in order to ensure high availability. The current rate limit for the new endpoints is 1000 requests per minute.

These limits will change before going to production, and changes will be updated in this document.

 

Further development

The new API is still under development and can change. The response format is still a work in progress, and we are open to input from consumers. In a more distant future, we will also be able to increase performance when we are able to prioritize some necessary internal changes in Elhub.

 

Useful links

 

Contact information

To reach us please use our github discussions forum.

For more user specific queries use utvikler@elhub.no.