Skip to content

Get readings

anglian_water.get_readings Service

This service allows you to retrieve raw water usage data directly from Anglian Water within Home Assistant. This data can be useful for more advanced automations or visualizations that require the underlying readings.

How it works:

When you call this service, it specifies a date range and retrieves detailed water consumption information from Anglian Water's API for that period. The retrieved data is returned directly in the service response.

Service Call Parameters:

  • start (required): This parameter specifies the start date for retrieving data. The format should be YYYY-MM-DD (e.g., 2025-01-10).
  • end (required): This parameter specifies the end date for retrieving data. The format should be YYYY-MM-DD (e.g., 2025-01-12).

Service Response:

The service returns a dictionary containing the raw water usage data from Anglian Water. The specific format of the data depends on Anglian Water's API response.

Important Notes:

  • This service retrieves raw data and may require further processing or interpretation depending on your specific needs. Refer to the Anglian Water API documentation (if available) for details about the returned data structure.
  • This service relies on the Anglian Water API, which may be unavailable at times due to maintenance or other reasons.
  • The Anglian Water API provides meter readings approximately once every 24 hours. This means the retrieved data may lag behind by up to a day.

For advanced usage and troubleshooting information related to the Anglian Water integration and its interaction with the Anglian Water API, refer to the relevant documentation section.