Learn how tariffs, tariff rates, tariff rate bands, documents, and tariff properties are modeled.
Tariffs are rate plans for electricity. They describe who the plan applies to (service and applicability), what the charges are, and other information about this electricity service:
- We have residential tariffs and general tariffs (commercial & industrial), and specialty (agriculture, transport, lighting).
- You can specify whether you want the tariff fully populated, or whether you just want a sub-section of the data (to avoid charges and to speed up your queries).
Related endpoints
Data Definitions
The complete tariff data is a hierarchy of many objects. The header object is the Tariff, which contains zero or more TariffRate objects. Think of a tariff rate like a line item on your bill. Each tariff rate has one or more TariffRateBand objects. Some charges can be banded to contain several levels based on demand, consumption, or other thresholds. This structure is designed to support the complexity found in the large array of tariff plans that are in the market.
TariffId versus MasterTariffId
Tariff data changes periodically. E-1 Residential in PG&E territory, for example, usually changes a few times per year. For each revision, we created a new tariff with a unique tariffId. Logically, however, each of these new tariffs is just a different version of a single "master" tariff. This family of tariffs is tied together with the masterTariffId property. Again using E-1 as an example, each version of the tariff will have a different tariffId, but they all have the same masterTariffId -- 522.
Taxes
The Arcadia database only has rates that appear in utility tariff books. That means that it does not have state, local, and other tax rates. That doesn't mean that you can't include them in a calculation, though. We have a quick how-to on exactly how to do that.
Tariff
The Tariff object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| tariffId | Long | M | Unique Arcadia ID (primary key) for this tariff |
| masterTariffId | Long | M | Unique Arcadia ID that persists across all revisions of this tariff |
| tariffCode | String | M | Short code that the LSE uses as an alternate name for the tariff |
| tariffName | String | M | Name of the tariff as published by the LSE |
| tariffBookName | String | E | Name of the tariff as it appears in the tariff documentation |
| lseId | Long | M | ID of load serving entity this tariff belongs to |
| lseName | String | M | Name of the load-serving entity |
| lseCode | String | E | Abbreviated short code of the load-serving entity |
| serviceType | String | M | Type of service for the tariff. Current values include ELECTRICITY, SOLAR_PV, and GAS |
| priorTariffId | Long | Unique Arcadia ID that identifies the prior revision of the tariffId | |
| distributionLseId | Long | In states like Texas where the load-serving entity that sells the power can be different than the load-serving entity that distributes the power, this will contain the ID of the distribution LSE. Otherwise, it will be null. | |
| tariffType | String | Possible values are: DEFAULT - tariff that is automatically given to this service class ALTERNATIVE - opt-in alternate tariff for this service class OPTIONAL_EXTRA - opt-in extra, such as green power or a smart thermostat program RIDER - charge that can apply to multiple tariffs. Often a regulatory-mandated charge | |
| customerClass | String | Possible values are: RESIDENTIAL - homes, apartments etc. GENERAL - commercial, industrial, and other business and organization service types (often have additional applicability criteria) SPECIAL_USE - examples are government, agriculture, street lighting, transportation PROPOSED - Utility rates that have been proposed by utilities and approved by utility commissions, but are not yet effective (requires product subscription) | |
| customerCount | Integer | Number of customers that are on this master tariff | |
| customerLikelihood | Decimal | The likelihood that a customer is on this tariff of all the tariffs in the search results. Only populated when getting more than one tariff. | |
| customerCountSource | String | E | Where we got the customer count numbers from. Typically FERC (form 1 filings) or Arcadia (our own estimates). |
| territoryId | String | ID of the territory that this tariff applies to. This is typically the service area for the LSE in this regulatory region (i.e. a state in the USA) | |
| effectiveDate | DateTime | Date on which the tariff was or will be effective | |
| endDate | DateTime | Date on which this tariff is no longer effective. Can be null which means end date is not known or tariff is open-ended | |
| closedDate | Date | E | Date on which a tariff became closed to new customers, but still available for customers who were on it at the time. Can be null which means that the tariff is not closed. All versions of a particular tariff (i.e. those that share a particular masterTariffId) will have the same closedDate value. |
| effectiveOnRule | String | Property of the tariff determining when the tariff takes effect. Possible values: TARIFF_EFFECTIVE_DATE, BILLING_PERIOD_START | |
| timeZone | String | If populated (usually is), it's the timezone that this tariffs dates and times refer to | |
| billingPeriod | String | How frequently bills are generated. | |
| currency | String | ISO Currency code that the rates for this tariff refer to (e.g. USD for USA Dollar) | |
| chargeTypes | String | A comma-separated list of all the different ChargeType rates on this tariff (see field on TariffRate below). | |
| chargePeriod | String | The most fine-grained period for which charges are calculated. | |
| minMonthlyConsumption | Decimal | E | When applicable, the minimum monthly consumption allowed to be eligible for this tariff. |
| maxMonthlyConsumption | Decimal | E | When applicable, the maximum monthly consumption allowed to be eligible for this tariff. |
| minMonthlyDemand | Decimal | E | When applicable, the minimum monthly demand allowed to be eligible for this tariff. |
| maxMonthlyDemand | Decimal | E | When applicable, the maximum monthly demand allowed to be eligible for this tariff. |
| hasTimeOfUseRates | Boolean | Indicates whether this tariff contains one or more Time of Use Rate. | |
| hasTieredRates | Boolean | Indicates whether this tariff contains one or more Tiered Rate. | |
| hasContractedRates | Boolean | Indicates whether this tariff contains one or more Rate that can be contracted (sometimes called by-passable or associated with a price to compare). | |
| hasTariffApplicability | Boolean | E | Indicates that this tariff has additional eligibility criteria, as specified in the TariffProperty collection (below). |
| hasRateApplicability | Boolean | Indicates that one or more rates on this tariff are only applicable to customers with a particular circumstance. When true, this will be specified in the TariffProperty collection, and also on the TariffRate or rates in question. | |
| hasNetMetering | Boolean | E | Indicates whether this tariff contains one or more net metered rates. |
| privacy | String | E | Privacy status of the tariff. Possible values are PUBLIC, UNLISTED or PRIVATE. |
| properties | List of TariffProperty | The properties on this tariff. See below for the TariffProperty structure. | |
| rates | List of TariffRate | The rates for this tariff. See below for TariffRate structure | |
| documents | List of TariffDocument | The documents for this tariff. See below for TariffDocument structure |
Tariff Rate
The TariffRate object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| tariffRateId | Long | M | Unique Arcadia ID (primary key) for each tariff rate |
| tariffId | Long | M | Associates the rate with a tariff (foreign key) |
| riderTariffId | Long | E | Tariff ID of the rider attached to this tariff version. null otherwise |
| riderId | Long | M | Master Tariff ID of the rider linked to this tariff rate. |
| tariffSequenceNumber | Integer | M | Sequence of this rate in the tariff, for display purposes only (e.g. this is the order on the bill) |
| tariffBookSequenceNumber | Integer | E | Sequence of this rate in the tariff source document, if it differs from tariffSequenceNumber |
| rateGroupName | String | M | Name of the group this rate belongs to |
| tariffBookRateGroupName | String | E | Name of the group this rate belongs to in the tariff source document, if it differs from rateGroupName |
| rateName | String | M | Name of this rate. Can be null (in which case use the group name) |
| tariffBookRateName | String | E | Name of this rate in the tariff source document, if it differs from rateName |
| fromDateTime | DateTime | If populated, this indicates the rate's effective date is not the same as that of its tariff | |
| toDateTime | DateTime | If populated, this indicates the rates end date is not the same as that of its tariff | |
| territory | Territory | Only populated when this rate applies to a different region than the whole tariff (e.g. California Baseline Regions). This how-to has more. | |
| season | Season | The season this rate applies to. Only used for seasonal rates (null otherwise) | |
| timeOfUse | TimeOfUse | The time period this rate applies to. Only used for TOU rates (null otherwise) | |
| chargeType | String | Possible values are: FIXED_PRICE - a fixed charge for the period CONSUMPTION_BASED - based on quantity used (e.g. kW/h) DEMAND_BASED - based on the peak demand (e.g. kW) QUANTITY - a rate per number of items (e.g. $5 per street light) FORMULA - a rate that has a specific or custom formula MINIMUM - a minimum amount that the LSE will charge you, overriding lower pre-tax charges MAXIMUM - a maximum amount that the LSE will charge you, overriding higher pre-tax charges TAX - a percentage or fixed cost tax rate which is applied to the sum of all of the other charges on a bill | |
| chargeClass | String | A comma-separated string that indicates what class(es) of charges this rate is for. Values include: SUPPLY - Energy-related charges. TRANSMISSION - Transmission level delivery charges. DISTRIBUTION - Distribution level (last mile) delivery charges of moving electricity into your home or business. TAX - Tax surcharges that appear in the utility tariff document. CONTRACTED - Charges that get replaced or overridden when you pass the retail (contracted) energy supply rate in the calculation. USER_ADJUSTED - Additional or custom rates you can add to a public or private tariff. An example would be a local tax rate which Arcadia does not model but you would want included. AFTER_TAX - Charges which apply post utility and other taxes. A good example would be the California Climate credit which is applied to the bill after the taxes are applied to the bill subtotal. OTHER - Charges which cannot be classified in any of the above buckets. This is very rare. NON_BYPASSABLE - Charges which cannot be offset by credits (usually Net Metering) | |
| chargePeriod | String | Indicates what period this charge is calculated for. This is usually the same as the billing period (and is usually monthly) but can be other intervals. Possible values are: MONTHLY - each calendar month DAILY - calculated for each day QUARTERLY - every 3 months ANNUALLY - every year | |
| transactionType | String | E | Indicates whether this rate is BUY (charge when importing from the grid, no credit when exporting), SELL (credit when exporting to the grid, no charge when importing), or NET (charge when importing, credit when exporting) with imports and exports resolved according to the chargePeriod. BUY_IMPORT (charge only when importing) and SELL_EXPORT (credit only when exporting) indicate that imports and exports are resolved in real-time (instantaneous netting). |
| quantityKey | String | When not null, the property that defines the type of quantity this rate applies to. (e.g. billingMeter : property which defines the number of billing meters the rate will apply to) | |
| applicabilityKey | String | When not null, the property that defines the eligibility criteria for this rate. (e.g. connectionType : property which defines how the service is connected to the grid) | |
| variableLimitKey | String | When populated this defines the variable which determines the upper limit(s) of this rate. (e.g. demandMultiplierTierswithkWhTiers2416: property which uses the demand value to drive the consumption limits) | |
| variableRateKey | String | When not null, this is the name of the property that defines the variable rate. In this case, the rate field is null, or can (rarely) be used as an input to the determination of the variable rate. (e.g massachusettsResidentialRetailPrevailingRates : property which provides the regional prevailing residential supply rate for Massachusetts ) | |
| variableFactorKey | String | When not null, this is the name of the property that defines the variable factor to apply to this rate. (e.g billingPeriodProrationFactor: property which defines a prorated number of billing days) | |
| rateBands | List of TariffRateBand | See the data definition below |
Tariff Rate Band
The TariffRateBand object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| tariffRateBandId | Long | Unique Arcadia ID (primary key) for each Band | |
| tariffRateId | Long | ID of the rate this band belongs to (foreign key) | |
| rateSequenceNumber | Integer | This band's position in the bands for its rate | |
| hasConsumptionLimit | Boolean | true indicates that this has banded consumption | |
| consumptionUpperLimit | Decimal | When hasConsumptionLimit is true, this indicates the upper consumption limit of this band. null means no upper limit | |
| hasDemandLimit | Boolean | true indicates that this has banded demand | |
| demandUpperLimit | Decimal | When hasDemandLimit is true, this indicates the upper demand limit of this band. null means no upper limit | |
| hasPropertyLimit | Boolean | true indicates that this has a limit based on a property | |
| propertyUpperLimit | Decimal | When hasPropertyLimit is true, this indicates the upper limit of this band. null means no upper limit | |
| prevUpperLimit | Integer | The upper limit of the previous rate band for this rate | |
| applicabilityValue | String | When not null, this indicates the value of applicability property that qualifies for this rate. | |
| calculationFactor | Decimal | A factor to be applied to the cost of the rate. | |
| rateAmount | Decimal | Charge amount for this band | |
| rateUnit | String | Possible values are: COST_PER_UNIT - rate amount multiplied by the number of units PERCENTAGE - percentage of a value (e.g. percentage of overall bill) | |
| isCredit | Boolean | When true this band is a credit amount (reduces the bill) |
Tariff Document
The TariffDocument object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| tariffId | Long | The tariff ID associated with this document | |
| documentId | Long | Unique ID of the document associated with this tariff | |
| documentSectionId | Long | Unique ID of the section of the documentSection associated with this tariff | |
| document | Document | The Document object associated with this tariff |
Document
The Document object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| documentId | Long | Unique ID of this document | |
| documentTitle | String | Title of this document | |
| archiveUrl | String | URL for Arcadia archive of this document | |
| sourceUrl | String | URL for source document (if applicable) | |
| sourceContentType | String | Type of source document, possible values are (???) | |
| lseId | Long | ID of the LSE associated with this document | |
| lseName | String | Name of the LSE associated with this document | |
| territoryId | Long | ID of the territory associated with this document | |
| territoryName | String | Name of the territory associated with this document | |
| sequenceNumber | Integer | The position of this document in all documents for the LSE | |
| parentDocumentId | Long | The documentId of the parent document of this document, if this document is part of a collection | |
| sections | List of DocumentSection | Document sections, typically corresponding to specific tariffs | |
| priorDocumentId | Long | documentId of the document for the previous version of this tariff |
Document Section
The DocumentSection object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| documentSectionId | Long | Unique ID of this document section | |
| documentId | Long | Unique ID of the document associated with this section | |
| sectionHeading | String | Title of the document section | |
| sectionType | String | Possible values are SERVICE, TARIFF, CLIMATE_ZONE, or UTILITY_CLIMATE_ZONE | |
| startPage | Integer | The page number of the document this section starts on | |
| customerClass | String | The type of customer this document section concerns. Possible values are GENERAL, RESIDENTIAL, SPECIAL_USE or PROPOSED | |
| revised | Boolean | Whether this document has been revised from the original | |
| priorDocumentSectionId | Long | Unique ID of the document section for the previous version of this tariff |
Tariff Property
Tariff properties represent metadata about a tariff. They might tell you things like, "What values are required to do a calculation with this tariff?" or "What do I have to do to be eligible for this tariff?" They're broken down into many types, the most important of which are listed below.
APPLICABILITIES
Tariff properties of type APPLICABILITY tell you whether or not a customer is eligible to receive service under a particular tariff. For example, a tariff that is only for electric vehicles might have the hasElectricVehicle applicability property.
RATE CRITERIA
Tariff properties of type RATE_CRITERIA represent things that you need to know to properly calculate the tariff. This includes obvious things like consumption and demand, but also things like dailyMedicalAllowance or isSmartRateCustomer.
For things other than consumption and demand, we usually set a reasonable default value so you don't have to answer questions about every single property before doing a calculation. If you want to set these values yourself, though, you can do that by running through the list of properties returned when you set populateProperties to true when getting a tariff.
DATA STRUCTURE
The TariffProperty object has the following data structure.
| Name | Type | Fields | Description |
|---|---|---|---|
| keyName | String | M | Unique name for this property |
| period | String | If applicable the type of time of use. Possible values are "ON_PEAK", "PARTIAL_PEAK", "OFF_PEAK", and "CRITICAL_PEAK". | |
| displayName | String | M | The display name of this property |
| keyspace | String | M | Top-level categorization of the property hierarchy |
| family | String | M | Second level categorization of the property hierarchy, below keyspace |
| description | String | M | A longer description of the tariff property. Good for further explanation as part of a customer "questionnaire" |
| dataType | String | M | The data type of this property. Possible values are string, choice, boolean, date, decimal, integer, formula, demand |
| propertyTypes | String | M | The category of property. Possible values are APPLICABILITY, RATE_CRITERIA, BENEFIT, DATA_REPUTATION, SERVICE_TERMS |
| operator | String | The mathematical operator associated with this property's value, where applicable. | |
| propertyValue | String | If applicable the specific value of this property. | |
| minValue | String | If applicable the minimum value of this property. | |
| maxValue | String | If applicable the maximum value of this property. | |
| choices | Array of Choices | The possible choices for this array | |
| formulaDetail | String | If this property is a FORMULA type, the formula details will be in this field. | |
| isDefault | Boolean | Whether the value of this Property is the default value. |
Here's an example in JSON of a fully populated tariff, containing tariff rates and tariff rate bands:
{
"tariffId":512,
"masterTariffId":512,
"priorTariffId":null,
"lseId":2756,
"lseName":"Georgia Power Co",
"distributionLseId":null,
"tariffCode":"R-17",
"tariffName":"Residential Service",
"tariffType":"DEFAULT",
"customerClass":"RESIDENTIAL",
"territoryId":3114,
"effectiveDate":"2011-03-01T00:00:00.000-0800",
"endDate":null,
"isActive":true,
"hasNetMetering":true,
"minMonthlyConsumption":null,
"maxMonthlyConsumption":null,
"minMonthlyDemand":null,
"maxMonthlyDemand":null,
"billingPeriod":"MONTHLY",
"properties":null,
"timeZone":"US/Eastern",
"currency":"USD",
"rates":[
{
"tariffRateId":2734,
"tariffId":512,
"riderId":null,
"tariffSequenceNumber":0,
"rateGroupName":"Basic Service Charge",
"rateName":"Basic Service Charge",
"territory":null,
"season":null,
"timeOfUse":null,
"chargeType":"FIXED_PRICE",
"chargePeriod":"MONTHLY",
"quantityKey":null,
"applicabilityKey":null,
"variableLimitKey":null,
"rateBands":[
{
"tariffRateBandId":3258,
"tariffRateId":2734,
"rateSequenceNumber":1,
"hasConsumptionLimit":false,
"consumptionUpperLimit":null,
"hasDemandLimit":false,
"demandUpperLimit":null,
"hasPropertyLimit":false,
"propertyUpperLimit":null,
"applicabilityValue":null,
"calculationFactor":null,
"rateAmount":.090000,
"rateUnit":"COST_PER_UNIT",
"isCredit":false
}
]
},
{
"tariffRateId":2735,
"tariffId":512,
"riderId":null,
"tariffSequenceNumber":1,
"rateGroupName":"Energy Charges",
"rateName":"Winter Energy Charges",
"territory":null,
"season":{
"seasonId":314,
"lseId":2756,
"seasonGroupId":3,
"seasonName":"Winter",
"seasonFromMonth":10,
"seasonFromDay":1,
"seasonToMonth":5,
"seasonToDay":31
},
"timeOfUse":null,
"chargeType":"CONSUMPTION_BASED",
"chargePeriod":"MONTHLY",
"quantityKey":null,
"applicabilityKey":null,
"variableLimitKey":null,
"rateBands":[
{
"tariffRateBandId":3259,
"tariffRateId":2735,
"rateSequenceNumber":1,
"hasConsumptionLimit":true,
"consumptionUpperLimit":650.0,
"hasDemandLimit":false,
"demandUpperLimit":null,
"hasPropertyLimit":false,
"propertyUpperLimit":null,
"applicabilityValue":null,
"calculationFactor":null,
"rateAmount":.050633,
"rateUnit":"COST_PER_UNIT",
"isCredit":false
},
{
"tariffRateBandId":3260,
"tariffRateId":2735,
"rateSequenceNumber":2,
"hasConsumptionLimit":true,
"consumptionUpperLimit":1000.0,
"hasDemandLimit":false,
"demandUpperLimit":null,
"hasPropertyLimit":false,
"propertyUpperLimit":null,
"applicabilityValue":null,
"calculationFactor":null,
"rateAmount":.043443,
"rateUnit":"COST_PER_UNIT",
"isCredit":false
},
{
"tariffRateBandId":3261,
"tariffRateId":2735,
"rateSequenceNumber":3,
"hasConsumptionLimit":true,
"consumptionUpperLimit":null,
"hasDemandLimit":false,
"demandUpperLimit":null,
"hasPropertyLimit":false,
"propertyUpperLimit":null,
"applicabilityValue":null,
"calculationFactor":null,
"rateAmount":.042647,
"rateUnit":"COST_PER_UNIT",
"isCredit":false
}
]
},
]
}
Get a List of Tariffs
This allows you to search for a set of tariffs and get them back as a list of tariff objects in the standard response format.
Resource URI
GET /rest/public/tariffs
Request Parameters
Along with the standard pagination parameters, searching and sorting parameters, and the required security parameters, the following parameters are available as part of the request:
| Name | Type | Description |
|---|---|---|
| lseId | Long | Filter tariffs for a specific LSE (Optional) |
| masterTariffId | Long | If specified, all versions of a tariff belonging to the master tariff Id are returned. (Optional) |
| effectiveOn | DateTime | Only tariffs that are effective on this date (Optional) |
| openOn | Date | Only tariffs that were open (i.e. were not closed to new customers) on this date (Optional) See example |
| isActive | Boolean | Only the current, active tariff version for the LSE or master tariff Id. (Optional) |
| fromDateTime | DateTime | Only include tariffs that are effective on or after this date (Optional) |
| toDateTime | DateTime | Only include tariffs that are effective on or before this date (Optional) |
| customerClasses | String | Comma-separated string that indicates the customer classes to include. Choices are: RESIDENTIAL, GENERAL, SPECIAL_USE (Optional) |
| chargeTypes | String | Comma-separated string that indicates the charge types to include. Choices are: FIXED_PRICE, CONSUMPTION_BASED, DEMAND_BASED, QUANTITY, MINIMUM, TAX, NET_EXCESS_GENERATION (Optional) |
| tariffTypes | String | Comma-separated string that indicates the tariff types to include. Choices are: DEFAULT, ALTERNATIVE, OPTIONAL_EXTRA, RIDER (Optional) |
| serviceTypes | String | Comma-separated string that indicates the service types to include. Choices are: ELECTRICITY, SOLAR_PV, GAS (Optional, default is all serviceTypes) |
| privacyFlags | String | Comma-separated string that indicates the privacy flags types to include. Only applicable if you publish private tariffs. Choices are: PUBLIC, UNLISTED, PRIVATE (Optional) |
| zipCode | String | (Optional but Recommended) Use this to return just the Tariffs that are for this given location. Most Tariffs apply for a regional, not national, geography. |
| postCode | String | Alias for zipCode. You can use either. |
| addressString | String | An alternative to using zipCode. Use this if you do not have the address parsed out in your app, but instead have a long string. For the best results, this string will contain a zip code or postal code. We recommend processing the address on your side and passing either zipCode or postCode. |
| lat | Float | (Optional) Represents the latitude of a geographical location. This should be paired with lng when not supplying a zip code or address. |
| lng | Float | (Optional) Represents the longitude of a geographical location. This should be paired with lat when not supplying a zip code or address. |
| riderId | Long | When set to the masterTariffId of a Rider, this will return all of the tariffs that the rider is used on (Optional) |
| populateProperties | Boolean | Populates the properties for the returned tariffs (Optional; defaults to false) |
| populateRates | Boolean | Populates the rate details for the returned tariffs (Optional; defaults to false) |
| populateDocuments | Boolean | Populates the document links for the returned tariffs (Optional; defaults to false) |
| consumption | Decimal | Return tariffs which are eligible for this consumption amount (Optional) |
| demand | Decimal | Return tariffs which are eligible for this demand amount (Optional) |
| hasNetMetering | Boolean | Return tariffs that have or do not have any net-metered tariff rates (Optional) |
| hasTimeOfUseRates | Boolean | Return tariffs which have or do not have any time-of-use rates (Optional) |
| hasTieredRates | Boolean | Return tariffs which have or do not have any tiered rates (Optional) |
| hasContractedRates | Boolean | Return tariffs which have or do not have any contracted rates (Optional) |
| bundleRates | Boolean | When true (false by default) the rates are summarized (bundled). Note that this only works for tariffs with a customerClass of RESIDENTIAL. (Optional) |
| applicableRatesOnly | Boolean | When true (false by default) you'll only get back rates that match the default rate applicability values set on the tariff. Please note that this works off tariff defaults and cannot be configured. (Optional) |
| filterRiderRates | Boolean | Used in concert with populateRates = true, when filterRiderRates = true (false by default) rider rates will not be returned. However, pointers to the riders will be returned. This is used primarily to distill base tariff rates. |
Example 1 - Retrieving Residential Tariffs for a Zip Code
In this example, we query for all residential tariffs in the 94115 ZIP code. We also request to populate the properties. In the response, the territoryId property is returned with a default value, which is the territoryId that matches the requested ZIP code. This is helpful when working with tariffs with rates that vary by geographic location.
GET /rest/public/tariffs?zipCode=94115&populateProperties=true&customerClasses=RESIDENTIAL
{
"status":"success",
"count":40,
"type":"Tariff",
"results":[
{
"tariffId":518,
"masterTariffId":518,
"priorTariffId":518,
"lseId":734,
"lseName":"Pacific Gas & Electric Co",
"distributionLseId":null,
"tariffCode":"E-7",
"tariffName":"Residential Time-Of-Use Service E-7 (Basic)",
"tariffType":"ALTERNATIVE",
"customerClass":"RESIDENTIAL",
"territoryId":807,
"effectiveDate":"2011-03-01",
"endDate":"2011-06-19",
"timeZone":"US/Pacific",
"isActive":false,
"hasNetMetering":true,
"minMonthlyConsumption":null,
"maxMonthlyConsumption":null,
"minMonthlyDemand":null,
"maxMonthlyDemand":null,
"billingPeriod":"MONTHLY",
"currency":"USD",
"properties":[
{
"keyName":"territoryId",
"displayName":"TerritoryId",
"family":"billing",
"keyspace":"electricity",
"description":"Territory id where tariff is operational",
"dataType":"CHOICE",
"choices":[
{
"value":"3542",
"displayValue":"Baseline Region Y"
},
{
"value":"3543",
"displayValue":"Baseline Region Z"
},
{
"value":"3540",
"displayValue":"Baseline Region W"
},
{
"value":"3541",
"displayValue":"Baseline Region X"
},
{
"value":"3538",
"displayValue":"Baseline Region T"
},
{
"value":"3539",
"displayValue":"Baseline Region V"
},
{
"value":"3536",
"displayValue":"Baseline Region R"
},
{
"value":"3537",
"displayValue":"Baseline Region S"
},
{
"value":"3535",
"displayValue":"Baseline Region Q"
},
{
"value":"3534",
"displayValue":"Baseline Region P"
}
],
"propertyTypes":"RATE_CRITERIA",
"operator":null,
"propertyValue":"3538",
"isDefault":true
},
{
"keyName":"consumption",
"displayName":"Consumption (kWh)",
"family":"load",
"keyspace":"electricity",
"description":"Quantity in kWh of load that is used for a period of time",
"dataType":"DECIMAL",
"choices":[
],
"propertyTypes":"RATE_CRITERIA",
"operator":null,
"isDefault":false
}
]
},
/* edited for length */
Example 2 - Excluding Closed Tariffs from Tariff Selection
Utilities may close a tariff to new customers and allow customers who are currently on the tariff to be grandfathered. Therefore, closed tariffs should typically be included unless you know for certain that the customer is not currently on a closed (legacy) tariff.
To exclude closed tariffs from the tariff list, add the openOn parameter to your Get Tariffs call:
GET /rest/public/tariffs?zipCode=93550&customerClasses=RESIDENTIAL&tariffTypes=DEFAULT,ALTERNATIVE&effectiveOn=2017-01-01&openOn=2017-01-01Example 3 - Retrieving Tariffs that have a given rider
This example shows how to pass in the masterTariffId of a particular rider to see where that rider is used (what tariffs it is attached to).
GET /rest/public/tariffs/?riderId=3163711
{
"status": "success",
"count": 67,
"type": "Tariff",
"results": [
{
"tariffId": 80886,
"masterTariffId": 80886,
"tariffCode": "ECT-1R",
"tariffName": "Residential - Time of Use, Combined Advantage, Demand, 9pm - 9 am (Closed)",
"lseId": 2885,
"lseName": "Arizona Public Service Co",
"tariffType": "ALTERNATIVE",
"customerClass": "RESIDENTIAL",
"customerCount": 47173,
"customerLikelihood": 6.1300,
"territoryId": 3255,
"effectiveDate": "2010-01-01",
"endDate": "2012-07-01",
"timeZone": "US/Arizona",
"billingPeriod": "MONTHLY",
"currency": "USD",
"chargeTypes": "FIXED_PRICE,CONSUMPTION_BASED,DEMAND_BASED,QUANTITY",
"chargePeriod": "DAILY",
"hasTimeOfUseRates": true,
"hasTieredRates": true,
"hasContractedRates": false,
"hasRateApplicability": true,
"isActive": false
},
// content redacted for brevity
"pageCount": 25,
"pageStart": 0
]
}Get One Tariff
This is how you retrieve a particular tariff.
Resource URI
GET /rest/public/tariffs/{masterTariffId}
Request Parameters
Along with the required security parameters, the following parameters are available as part of the request:
| Name | Type | Description |
|---|---|---|
| populateProperties | Boolean | Optional. Populates the properties for the Tariff |
| populateRates | Boolean | Optional. Populates the rate details, seasons, and TOU definitions for this Tariff |
| populateDocuments | Boolean | Optional. Populates the list of tariff book documents for the Tariff |
| effectiveOn | DateTime | Optional. Will only return the version of this tariff that is effective as of this date if populated. |
| territoryId | Long | Optional. Will only include this territory's rates and rates that apply to all territories if passed in. Note that rate filtering only occurs when applicableRatesOnly is set to true |
| bundleRates | Boolean | When true (false by default) the rates are summarized (bundled). Note that this only works for tariffs with a customerClass of RESIDENTIAL. (Optional) |
| applicableRatesOnly | Boolean | When true (false by default) rate applicability criteria will be applied to the rates. You'll only get back rates that match the request's rate applicability values, or the default rate applicability value as set on the tariff. (Optional) |
| lookupVariableRates | Boolean | When true (false by default) any variable price tariff rates will be looked up and returned on the response. Can work in conjunction with a passed-in date range. If used with effectiveOn, the date range returned will be the effectiveOn through one month later. (Optional). |
Example 1 - Retrieve Tariff with Tariff Properties
GET /rest/public/tariffs/809?populateProperties=true
{
"status": "success",
"count": 1,
"type": "Tariff",
"results": [
{
"tariffId": 3538383,
"masterTariffId": 809,
"tariffCode": "EL1",
"tariffName": "Residential and Religious",
"lseId": 2252,
"lseName": "Consolidated Edison Co-NY Inc",
"priorTariffId": 3491277,
"tariffType": "DEFAULT",
"customerClass": "RESIDENTIAL",
"customerCount": 3024550,
"customerLikelihood": null,
"territoryId": 2533,
"effectiveDate": "2026-02-01",
"endDate": null,
"timeZone": "US/Eastern",
"billingPeriod": "MONTHLY",
"currency": "USD",
"chargeTypes": "FIXED_PRICE,CONSUMPTION_BASED,QUANTITY,MINIMUM",
"chargePeriod": "DAILY",
"hasTimeOfUseRates": false,
"hasTieredRates": true,
"hasContractedRates": true,
"hasRateApplicability": true,
"isActive": true,
"properties": [
{
"keyName": "consumption",
"quantityKey": null,
"displayName": "Consumption (kWh)",
"family": "load",
"keyspace": "electricity",
"description": "Quantity in kWh of load that is used for a period of time",
"dataType": "DECIMAL",
"propertyTypes": "RATE_CRITERIA",
"operator": null,
"isDefault": false
},
{
"keyName": "eligibleForRiderM",
"quantityKey": null,
"displayName": "Eligible For RiderM",
"family": "customerStatus",
"keyspace": "customer",
"description": "RIDER M – DAY-AHEAD HOURLY PRICING Applicable customers",
"dataType": "BOOLEAN",
"propertyTypes": "RATE_CRITERIA",
"operator": "=",
"propertyValue": "false",
"isDefault": true
},
{
"keyName": "systemSize",
"quantityKey": null,
"displayName": "System Size",
"family": "system",
"keyspace": "solarPV",
"description": "Nameplate capacity (kW).",
"dataType": "DECIMAL",
"propertyTypes": "RATE_CRITERIA",
"operator": "=",
"propertyValue": "0",
"isDefault": true
},
{
"keyName": "territoryId",
"quantityKey": null,
"displayName": "Territory",
"family": "billing",
"keyspace": "electricity",
"description": "Rate Baseline Region",
"dataType": "CHOICE",
"propertyTypes": "RATE_CRITERIA",
"operator": null,
"choices": [
{
"displayValue": "Zone H",
"value": "3632",
"dataValue": "3632",
"likelihood": null
},
{
"displayValue": "Zone I",
"value": "3633",
"dataValue": "3633",
"likelihood": null
},
{
"displayValue": "Zone J",
"value": "3634",
"dataValue": "3634",
"likelihood": null
}
],
"isDefault": true
},
{
"keyName": "chargeClass",
"quantityKey": null,
"displayName": "Charge Class Type",
"family": "service",
"keyspace": "electricity",
"description": "The tariff has rates with the following charge class.",
"dataType": "CHOICE",
"propertyTypes": "SERVICE_TERMS",
"operator": "=",
"propertyValue": "DISTRIBUTION,SUPPLY,CONTRACTED",
"choices": [
{
"displayValue": "Transmission",
"value": "1",
"dataValue": "1",
"likelihood": null
},
{
"displayValue": "Distribution",
"value": "2",
"dataValue": "2",
"likelihood": null
},
{
"displayValue": "Supply",
"value": "4",
"dataValue": "4",
"likelihood": null
},
{
"displayValue": "Tax",
"value": "8",
"dataValue": "8",
"likelihood": null
},
{
"displayValue": "Other",
"value": "16",
"dataValue": "16",
"likelihood": null
},
{
"displayValue": "Contracted",
"value": "32",
"dataValue": "32",
"likelihood": null
}
],
"isDefault": false
}
]
}
]
}Example 2 - Retrieve Tariff with Tariff Rates Populated
Note that when you populate rates, this MTID will be counted towards your usage total for the billing period.
GET /rest/public/tariffs/823?populateProperties=true&populateRates=true&lookupVariableRates=true
{
"status": "success",
"count": 1,
"type": "Tariff",
"results": [
{
"tariffId": 3284480,
"masterTariffId": 823,
"tariffCode": "R-1",
"tariffName": "Residential",
"lseId": 310,
"lseName": "National Grid - Massachusetts",
"priorTariffId": 3279572,
"tariffType": "DEFAULT",
"customerClass": "RESIDENTIAL",
"customerCount": 1006774,
"customerLikelihood": null,
"territoryId": 328,
"effectiveDate": "2017-05-01",
"endDate": null,
"timeZone": "US/Eastern",
"billingPeriod": "MONTHLY",
"currency": "USD",
"chargeTypes": "FIXED_PRICE,CONSUMPTION_BASED,MINIMUM",
"chargePeriod": "MONTHLY",
"hasTimeOfUseRates": false,
"hasTieredRates": false,
"hasContractedRates": true,
"hasRateApplicability": true,
"isActive": true,
"properties": [
{
"keyName": "basicServiceChargeType",
"quantityKey": null,
"displayName": "Basic Service Charge Type",
"family": "billing",
"keyspace": "electricity",
"description": "Basic Service Charge Type can be either Fixed or Variable rate.",
"dataType": "CHOICE",
"propertyTypes": "RATE_CRITERIA",
"operator": "=",
"propertyValue": "Fixed",
"choices": [
{
"displayValue": "Fixed",
"value": "Fixed",
"dataValue": "Fixed",
"likelihood": null
},
{
"displayValue": "Variable",
"value": "Variable",
"dataValue": "Variable",
"likelihood": null
}
],
"isDefault": true
},
{
"keyName": "consumption",
"quantityKey": null,
"displayName": "Consumption (kWh)",
"family": "load",
"keyspace": "electricity",
"description": "Quantity in kWh of load that is used for a period of time",
"dataType": "DECIMAL",
"propertyTypes": "RATE_CRITERIA",
"operator": "",
"isDefault": false
},
{
"keyName": "chargeClass",
"quantityKey": null,
"displayName": "Charge Class Type",
"family": "service",
"keyspace": "electricity",
"description": "The tariff has rates with the following charge class.",
"dataType": "CHOICE",
"propertyTypes": "SERVICE_TERMS",
"operator": "=",
"propertyValue": "SUPPLY, CONTRACTED, TRANSMISSION, DISTRIBUTION",
"choices": [
{
"displayValue": "Transmission",
"value": "1",
"dataValue": "1",
"likelihood": null
},
{
"displayValue": "Distribution",
"value": "2",
"dataValue": "2",
"likelihood": null
},
{
"displayValue": "Supply",
"value": "4",
"dataValue": "4",
"likelihood": null
},
{
"displayValue": "Tax",
"value": "8",
"dataValue": "8",
"likelihood": null
},
{
"displayValue": "Other",
"value": "16",
"dataValue": "16",
"likelihood": null
},
{
"displayValue": "Contracted",
"value": "32",
"dataValue": "32",
"likelihood": null
}
],
"isDefault": false
}
],
"rates": [
{
"tariffRateId": 17838923,
"tariffId": 3284480,
"tariffSequenceNumber": 22,
"rateGroupName": "Customer Charge",
"rateName": "Customer Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "FIXED_PRICE",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575434,
"tariffRateId": 17838923,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 5.5,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838924,
"tariffId": 3284480,
"tariffSequenceNumber": 23,
"rateGroupName": "Energy Efficiency Chg",
"rateName": "Energy Efficiency Chg",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575435,
"tariffRateId": 17838924,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.0025,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838925,
"tariffId": 3284480,
"tariffSequenceNumber": 24,
"rateGroupName": "Renewable Energy Chg",
"rateName": "Renewables Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575436,
"tariffRateId": 17838925,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.0005,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838926,
"tariffId": 3284480,
"tariffSequenceNumber": 25,
"rateGroupName": "Energy Efficiency Chg",
"rateName": "Energy Efficiency Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "energyEfficiencyReconcilingFactorR1",
"rateBands": [
{
"tariffRateBandId": 11575437,
"tariffRateId": 17838926,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.01833,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838927,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Basic Service Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575438,
"tariffRateId": 17838927,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00228,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838928,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Pension/PBOP Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575439,
"tariffRateId": 17838928,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00287,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838929,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Residential Assistance Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575440,
"tariffRateId": 17838929,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00483,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838930,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Base Distribution Charge - Energy Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575441,
"tariffRateId": 17838930,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.04072,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838931,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Revenue Decoupling Mechanism",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575442,
"tariffRateId": 17838931,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00204,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838932,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Attorney General Counsel Expense",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575443,
"tariffRateId": 17838932,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00004,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838933,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Market Settlement Credit",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "marketSettlementCredit",
"rateBands": [
{
"tariffRateBandId": 11575444,
"tariffRateId": 17838933,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838937,
"tariffId": 3284480,
"tariffSequenceNumber": 27,
"rateGroupName": "Transmission Charge",
"rateName": "Transmission Charge Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "TRANSMISSION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575448,
"tariffRateId": 17838937,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00055,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838938,
"tariffId": 3284480,
"tariffSequenceNumber": 27,
"rateGroupName": "Transmission Charge",
"rateName": "Base Transmission Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "TRANSMISSION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575449,
"tariffRateId": 17838938,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.03001,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838939,
"tariffId": 3284480,
"tariffSequenceNumber": 28,
"rateGroupName": "Transition Charge",
"rateName": "Base Transition Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575450,
"tariffRateId": 17838939,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00025,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838940,
"tariffId": 3284480,
"tariffSequenceNumber": 28,
"rateGroupName": "Transition Charge",
"rateName": "Transition Charge Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575451,
"tariffRateId": 17838940,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00029,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838941,
"tariffId": 3284480,
"tariffSequenceNumber": 29,
"rateGroupName": "Dist Chg",
"rateName": "Smart Grid Distribution Adjmt",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575452,
"tariffRateId": 17838941,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00037,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838945,
"tariffId": 3284480,
"tariffSequenceNumber": 31,
"rateGroupName": "Minimum Charge",
"rateName": "Minimum Charge",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": null,
"chargeType": "MINIMUM",
"chargePeriod": "MONTHLY",
"rateBands": [
{
"tariffRateBandId": 11575456,
"tariffRateId": 17838945,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 5.5,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838934,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Net CapEx Factor",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": "2017-10-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "netCapExFactorR1R2",
"rateBands": [
{
"tariffRateBandId": 11575445,
"tariffRateId": 17838934,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00165,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838934,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Net CapEx Factor",
"fromDateTime": "2017-10-01T00:00:00-04:00",
"toDateTime": "2018-01-31T19:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "netCapExFactorR1R2",
"rateBands": [
{
"tariffRateBandId": 11575445,
"tariffRateId": 17838934,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838935,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Solar Cost Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": "2017-10-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "solarCostAdjustment310",
"rateBands": [
{
"tariffRateBandId": 11575446,
"tariffRateId": 17838935,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00016,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838935,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Solar Cost Adjustment",
"fromDateTime": "2017-10-01T00:00:00-04:00",
"toDateTime": "2018-01-31T19:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "solarCostAdjustment310",
"rateBands": [
{
"tariffRateBandId": 11575446,
"tariffRateId": 17838935,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00016,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838936,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Storm Replenishment Adjustment",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": "2017-07-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "stormReplenishmentAdjustment",
"rateBands": [
{
"tariffRateBandId": 11575447,
"tariffRateId": 17838936,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00266,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838936,
"tariffId": 3284480,
"tariffSequenceNumber": 26,
"rateGroupName": "Dist Chg",
"rateName": "Storm Replenishment Adjustment",
"fromDateTime": "2017-07-01T00:00:00-04:00",
"toDateTime": "2018-01-31T19:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "stormReplenishmentAdjustment",
"rateBands": [
{
"tariffRateBandId": 11575447,
"tariffRateId": 17838936,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.00266,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838942,
"tariffId": 3284480,
"tariffSequenceNumber": 29,
"rateGroupName": "Dist Chg",
"rateName": "Renewable Energy Recovery",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": "2017-11-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "renewableEnergyRecovery310",
"rateBands": [
{
"tariffRateBandId": 11575453,
"tariffRateId": 17838942,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.0005,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838942,
"tariffId": 3284480,
"tariffSequenceNumber": 29,
"rateGroupName": "Dist Chg",
"rateName": "Renewable Energy Recovery",
"fromDateTime": "2017-11-01T00:00:00-04:00",
"toDateTime": "2018-01-31T19:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "DISTRIBUTION",
"chargePeriod": "MONTHLY",
"variableRateKey": "renewableEnergyRecovery310",
"rateBands": [
{
"tariffRateBandId": 11575453,
"tariffRateId": 17838942,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"rateAmount": 0.0005,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838943,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Fixed Price",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": "2017-11-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialFixed",
"rateBands": [
{
"tariffRateBandId": 11575454,
"tariffRateId": 17838943,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Fixed",
"rateAmount": 0.09432,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838943,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Fixed Price",
"fromDateTime": "2017-11-01T00:00:00-04:00",
"toDateTime": "2018-01-31T19:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialFixed",
"rateBands": [
{
"tariffRateBandId": 11575454,
"tariffRateId": 17838943,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Fixed",
"rateAmount": 0.12673,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-05-01T00:00:00-04:00",
"toDateTime": "2017-06-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.07362,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-06-01T00:00:00-04:00",
"toDateTime": "2017-07-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.09684,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-07-01T00:00:00-04:00",
"toDateTime": "2017-08-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.09516,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-08-01T00:00:00-04:00",
"toDateTime": "2017-09-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.09494,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-09-01T00:00:00-04:00",
"toDateTime": "2017-10-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.09936,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-10-01T00:00:00-04:00",
"toDateTime": "2017-11-01T00:00:00-04:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.10261,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-11-01T00:00:00-04:00",
"toDateTime": "2017-12-01T00:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.10457,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2017-12-01T00:00:00-05:00",
"toDateTime": "2018-01-01T00:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.1177,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
},
{
"tariffRateId": 17838944,
"tariffId": 3284480,
"tariffSequenceNumber": 30,
"rateGroupName": "Supplier Services",
"rateName": "Variable Price",
"fromDateTime": "2018-01-01T00:00:00-05:00",
"toDateTime": "2018-01-31T19:00:00-05:00",
"chargeType": "CONSUMPTION_BASED",
"chargeClass": "SUPPLY,CONTRACTED",
"chargePeriod": "MONTHLY",
"applicabilityKey": "basicServiceChargeType",
"variableRateKey": "supplementForBasicServiceResidentialVariable",
"rateBands": [
{
"tariffRateBandId": 11575455,
"tariffRateId": 17838944,
"rateSequenceNumber": 1,
"hasConsumptionLimit": false,
"hasDemandLimit": false,
"hasPropertyLimit": false,
"applicabilityValue": "Variable",
"rateAmount": 0.14574,
"rateUnit": "COST_PER_UNIT",
"isCredit": false,
"prevUpperLimit": null
}
]
}
]
}
]
}