This change is available as of EnergyAI Release v3.47

Introduction

This guide outlines the upcoming updates in the GET /datahub/mandate endpoint, which returns the status of the consumer's consent from the Fluvius data hub.

Previously, users who received data from the Fluvius data hub could renew their mandates only after they expire, thus causing a temporary interruption of the generation of the EnergyAI insights. With the new functionality introduced in the Fluvius API, EnergyAI can inform users up to 3 months before expiration, so they renew proactively, ensuring the continuity of the service.

The endpoint has been extended to provide the following information:

1. Mandate renewal status: Is reported by the renewal_status field, and it appears 3 months before the mandate expires showing:
   • Whether the renewal is pending (TO_BE_RENEWED)
   • If the user has requested a renewal already (RENEWAL_REQUESTED)
   • Whether the mandate expiration date has passed, meaning the end user needs to request a new mandate in order to continue receiving energy insights. (EXPIRED)
2. Expiration date of the mandate: The date when the mandate is set to expire, reported in the expiration_date field.
3. Granularity: The data granularity that corresponds to this mandate, reported in the granularity field.