saltriverprojectenergyapi 1.0.5

Unofficial api for the Arizona Salt River Project (SRP) API

Salt River Project Client

This module provides a Python client for interacting with the Salt River Project (SRP) energy API. It allows users to retrieve energy usage data, billing information, and other related data from SRP.

Usage

Here is an example of how to use the Salt River Project Client:

from saltriverprojectenergyapi import SaltRiverProjectClient

# Initialize the client with your Billing Account and login info
client = SaltRiverProjectClient(
    billing_account="Billing Account Number",
    username="SRP email_address or login name",
    password="SRP password"
)

# Authenticate and Authorize the client.
# This is a boolean return value, so you can verify if the authentication
# and authorisation were successful or not.
is_authorised = client.authorise_login()

# Retrieve energy usage data
# The dates are passed in as string values with the format dd-mm-yyyy
energy_usage_data = client.get_hourly_usage(startDate='01-01-2025', endDate='01-05-2025')
# energy_usage_data is a EnergyUsageData object *See objects/data_classes.py
# Hourly Usage for the object is in the .energy_usage property, which is a List[] type of Hourly Energy Usage data.
for hourly_usage in energy_usage_data.energy_usage:
    print(hourly_usage)
# Weather data does not take any parameters, and just returns a full weather dataset.
weather_data = client.get_daily_weather()
# myWeatherData is a List[WeatherData] * See objects/weather_data.py

# Retrieve outage data for your billing account.
# The Outage Data endpoint does not take any parameters, and returns a SelfOutageData object.
outage_data = client.get_user_outage()
if outage_data.is_in_outage_area:
    print("User is in an outage area.)

Currently supported methods

Currently, this client api supports the following methods.

1. getHourlyUsage
2. getDailyWeather
3. getUserOutage

Features

• Retrieve energy usage data for a specified date range
• Retrieve weather data associated with your account