Rates Request
Rates Response
Bill Request
Bill Response
BillSavings Request
CustomerInfo{...}
Sector
Location{...}
Address{...}
PostalCode
Income
TaxFilingStatus
Meters[{...}]
Name
CurrentRate{...}
Id
ProposedRate{...}
Id
AnnualUtilityBillEscalation_Percent
EnergyProfiles[{...}]
{"Type": "Consumption", ...}
Name
Scenario
IntervalData{...}
Interpolation
IntervalConvention
Interval
Data[{...}]
Time
Energy_kWh
BillAmount
{"Type": "Production"}
Name
Scenario
IntervalData{...}
Interpolation
IntervalConvention
Interval
Data[{...}]
Time
Energy_kWh
{"Type": "Pv", ...}
Name
Scenario
EquipmentLife_Years
SystemDegradationPerYear_Percent
ProductionEnergyProfileName
PvSimulation{...}
EnergySite{...}
Location{...}
Latitude
Longitude
PvSystems[{...}]
Albedo_Percent
GeneralDerate_Percent
Inverters[{...}]
Count
MaxPowerOutputAC_kW
EfficiencyRating_Percent
PvArrays[{...}]
PvModules[{...}]
Count
NameplateDCRating_kW
PtcRating_kW
PowerTemperatureCoefficient_PercentPerDegreeC
NominalOperatingCellTemperature_DegreesC
ArrayConfiguration{...}
Azimuth_Degrees
Tilt_Degrees
Tracking
TrackingRotationLimit_Degrees
MonthlyShadings[{...}]
MonthNumber
SolarAccess_Percent
CashPayment{...}
Cost
SaleMonth
SaleYear
LoanPayment{...}
Cost
InterestRate_Percent
LoanType
Term_Years
DownPaymentAmount
SaleMonth
SaleYear
LeasePayment{...}
Cost
FirstYearMonthlyPayment
PaymentFactor
AnnualPaymentEscalation_Percent
Term_Years
DownPaymentAmount
SaleMonth
SaleYear
PpaPayment{...}
Cost
PaymentPerkWh
AnnualPaymentEscalation_Percent
Term_Years
DownPaymentAmount
SaleMonth
SaleYear
MaintenanceCosts{...}
AnnualMaintenanceCost
OneTimeMaintenanceCost
OneTimeMaintenanceCostYear
BillPeriods[{...}]
Name
StartDate
BillPeriodEnd
EstimationOptions{...}
IncludeTaxEffects
OutputData[...]
BillSavings Response

EnergyProfiles{Consumption}

Meters.EnergyProfiles{Consumption}

 

A generic load profile for energy consumption. One consumption profile may be specified, or multiple profiles can be specified and BillSavings will combine them for you. You can specify the details of the load yourself by providing hourly, 30 minute, or 15 minute interval data, or if you specify annual or monthly load values, a load profile will be synthesized for you.


{
	"Type": "Consumption",
	"Name": "Whole House",
	"Scenario": "Both",
	"IntervalData": {
		"Interval": "Year",
		"Data": [{
			"Energy_kWh": 15092.0
		}]
	}
}

{
	"Type": "Consumption",
	"Name": "Whole House",
	"Scenario": "Both",
	"IntervalData": {
		"Interval": "Month",
		"IntervalConvention": "IntervalStart",
		"Data": [{
			"Time": "2014-01-01T00:00:00",
			"Energy_kWh": 756
		},
		{
			"Time": "2014-02-01T00:00:00",
			"Energy_kWh": 624
		},
		{
			"Time": "2014-03-01T00:00:00",
			"Energy_kWh": 634
		},
		{
			"Time": "2014-04-01T00:00:00",
			"Energy_kWh": 712
		},
		{
			"Time": "2014-05-01T00:00:00",
			"Energy_kWh": 761
		},
		{
			"Time": "2014-06-01T00:00:00",
			"Energy_kWh": 855
		},
		{
			"Time": "2014-07-01T00:00:00",
			"Energy_kWh": 940
		},
		{
			"Time": "2014-08-01T00:00:00",
			"Energy_kWh": 932
		},
		{
			"Time": "2014-09-01T00:00:00",
			"Energy_kWh": 893
		},
		{
			"Time": "2014-10-01T00:00:00",
			"Energy_kWh": 751
		},
		{
			"Time": "2014-11-01T00:00:00",
			"Energy_kWh": 716
		},
		{
			"Time": "2014-12-01T00:00:00",
			"Energy_kWh": 790
		}]
	}
} 

{
	"Type": "Consumption",
	"Name": "Whole House",
	"Scenario": "Both",
	"IntervalData": {
		"Interpolation": "Average",
		"Interval": "HalfHour",
		"IntervalConvention": "IntervalStart",
		"Data": [{
			"Time": "2014-11-09T00:00:00",
			"Energy_kWh": 0.19
		},
		{
			"Time": "2014-11-09T00:30:00",
			"Energy_kWh": 0.15
		},
		
		<em>Edited for length</em>
		
		{
			"Time": "2015-11-08T23:00:00",
			"Energy_kWh": 0.24
		},
		{
			"Time": "2015-11-08T23:30:00",
			"Energy_kWh": 0.26
		}]
	}
}

 

Name

A unique string to identify an energy profile. This is used in the response to associate things like incentives that apply to a specific energy profile.

Possible Values: A string such as “House” or “East Solar System”.

Default: When omitted, Name defaults to Type.

Scenario

Defines which scenario the energy profile is part of for the savings analysis.

Possible Values: A string equal to “Current”, “Proposed”, or “Both”.

Default: Proposed.

IntervalData

Contains load or bill data and meta data that defines the energy profile.

Required.