Rates Request
Rates Response
Bill Request
Bill Response
BillSavings Request
BillSavings Response
Location{...}
City
State
Bills[{...}]
MeterName
CurrentBill{...}
HoursInBill
Rate{...}
Id
Description
UtilityId
UtilityDescription
BillTotals{...}
MinimumBill
DemandCharge
EnergyCharge
FixedCharge
NetSurplusCompensation
TotalCharge
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
PeriodBills[{...}]
PeriodStart
PeriodEnd
PeriodName
BillTotals{...}
MinimumBill
DemandCharge
EnergyCharge
FixedCharge
NetSurplusCompensation
TotalCharge
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
ProductionCreditAccounting{...}
CreditUnit
CarryoverFromPreviousPeriod
AddedThisPeriod
AvailableThisPeriod
UsedThisPeriod
CarryoverToNextPeriod
AnnualTrueUp
Seasons[{...}]
Name
HoursInSeason
MinimumBill
FixedCharge
TouPeriods[{...}]
Name
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
MaxDemand_kW
EnergyCharges[{...}]
Tier
Energy_kWh
Charge
UnitPrice
Type
EnergyCredits[{...}]
Tier
Energy_kWh
Credit
UnitPrice
Type
DemandCharges[{...}]
Tier
Demand_kW
Charge
UnitPrice
Type
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
MaxDemand_kW
EnergyCharges[{...}]
Tier
Energy_kWh
Charge
UnitPrice
Type
EnergyCredits[{...}]
Tier
Energy_kWh
Credit
UnitPrice
Type
DemandCharges[{...}]
Tier
Demand_kW
Charge
UnitPrice
Type
ProposedBill{...}
HoursInBill
Rate{...}
Id
Description
UtilityId
UtilityDescription
BillTotals{...}
MinimumBill
DemandCharge
EnergyCharge
FixedCharge
NetSurplusCompensation
TotalCharge
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
PeriodBills[{...}]
PeriodStart
PeriodEnd
PeriodName
BillTotals{...}
MinimumBill
DemandCharge
EnergyCharge
FixedCharge
NetSurplusCompensation
TotalCharge
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
ProductionCreditAccounting{...}
CreditUnit
CarryoverFromPreviousPeriod
AddedThisPeriod
AvailableThisPeriod
UsedThisPeriod
CarryoverToNextPeriod
AnnualTrueUp
Seasons[{...}]
Name
HoursInSeason
MinimumBill
FixedCharge
TouPeriods[{...}]
Name
EnergyTotals
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
MaxDemand_kW
EnergyCharges
Tier
Energy_kWh
Charge
UnitPrice
Type
EnergyCredits
Tier
Energy_kWh
Credit
UnitPrice
Type
DemandCharges
Tier
Demand_kW
Charge
UnitPrice
Type
EnergyTotals{...}
Consumed_kWh
Produced_kWh
Purchased_kWh
Inflow_kWh
Outflow_kWh
MaxDemand_kW
EnergyCharges[{...}]
Tier
Energy_kWh
Charge
UnitPrice
Type
EnergyCredits[{...}]
Tier
Energy_kWh
Credit
UnitPrice
Type
DemandCharges[{...}]
Tier
Demand_kW
Charge
UnitPrice
Type
CashFlow{...}
Years[{...}]
Year
Summary{...}
CurrentTotal
ProposedTotal
NetSavingsTotal
CumulativeNetSavings
Details[{...}]
Current
Proposed
NetSavings
Component
Incentives{...}
Summary{...}
Cost
NetCost
Taxes
FederalTaxCredits
StateTaxCredits
LocalTaxCredits
Buydowns
OngoingIncentives
Details[{...}]
Name
Type
WebAddress
EnergyProfileName
TotalAmount
TotalTaxes
Years[{...}]
Year
Amount
Taxes
AmountBeforeTaxes
Emissions{...}
Current{...}
Units
CO2
NOX
SO2
Proposed{...}
Units
CO2
NOX
SO2

Seasons

Bills.CurrentBill.PeriodBills.Seasons

 

Contains energy use and bill information for each season within a billing period. Usually a billing period will only contain one season, but sometimes billing periods may span two different seasons.

Name

The name of the season.

Possible Values: A string such as “Winter”.

HoursInSeason

The number of hours in a given season. This is useful for understanding the breakdown of hours between seasons when a billing period spans more than one season.

Possible Values: An integer value such as 744.

MinimumBill

The minimum allowable charge for a bill. The minimum bill may be offset by net surplus compensation.

Possible Values: A decimal value such as 10.00.

FixedCharge

Charges associated per billing period regardless of total energy use. Fixed charges are usually assessed on a $/billing-period or a $/ day-billed basis.

Possible Values: A decimal value such as 10.00.

TouPeriods

Contains bill and energy details for time-of-use periods within a billing period. Rates without a time-of-use structure will not have TouPeriods.

EnergyTotals

Contains energy use details such as energy consumed, energy produced, and peak load. EnergyTotals is repeated throughout the response schema. When found at the billing period level under PeriodBills, EnergyTotals contains energy use details for that billing period. When found outside of PeriodBills, EnergyTotals contains energy use details with totals for all billing periods.

EnergyCharges

An array of charges associated with energy use for a given time period. EnergyCharges is repeated at various levels of the response schema. When found at the season level, EnergyCharges contains charges applicable to a particular season, such as block or tier charges. When found at the time of use level under TouPeriods, EnergyCharges contains charges applicable to a particular time of use block.

EnergyCredits

An array of credits associated with energy use for a given time period. EnergyCredits is repeated at various levels of the response schema. When found at the season level, EnergyCredits contains credits applicable to a particular season, such as block or tier charges. When found at the time of use level under TouPeriods, EnergyCredits contains credits applicable to a particular time of use block.

DemandCharges

An array of charges associated with energy use for a given time period. DemandCharges is repeated at various levels of the response schema. When found at the season level, DemandCharges contains charges applicable to a particular season, such as block or tier charges. When found at the time of use level under TouPeriods, DemandCharges contains charges applicable to a particular time of use block.