Tariff Rate Elements
In order to calculate a line item on an electric bill several data inputs are required. These inputs may include the rate for a charge in $/kwh or $/kw units, as well as the time period over which that rate is applied to usage as well as any other modifications to that rate which may be required as specified in the later section describing how we define tariff charges as Basis. The following is a complete list of the Tariff Rate Endpoints:
View Tariff Details
The following endpoint is utilized by our map UI to view the details of a particular tariff.
Note: The following output has been heavily condensed, and is solely to show the data structure.
curl –location –request POST ‘https://map.claritygrid.net/ecservice/view_tariff_details’ \
–header ‘Content-Type: application/json’ \
–header ‘ecservicesessions:
VJk6jTwXqY2Wy44dstway5VkTGX2FUV6PLVC1Bip1Yg67S5cOXn4U1376IePadGD’ \
–data-raw ‘{“distributor_tariff_id”: 5005}’
| Field Name | Data Type | Description | Example |
| utility | String | Common name of the utility/distributor that the tariff belongs to | “utility“: “Consolidated Edison Co. Of NY-Zone J”, |
| tariff | String | Common name of the tariff | “tariff“: “C-9 Gen Serv -Low Tension (NYC Zone J)”, |
| effective | String | Effective date of the tariff | “effective“: “2023-01-01”, |
| revision_reason | String | Reason for this version | “revision_reason“: “Effective Date”, |
| Monthly Charges | Collection | Collection of monthly charges |
“Monthly Charges“: { “charges“: [ { “Unit“: “Fixed”, “number“: 1, “cost“: 220.64, “unit“: “$/month”, “dataline“: “Charge 1 :info: $ 220.640000 $/month” }, { “Unit“: “Fixed”, “number“: 2, “cost“: 177.85, “unit“: “$/month”, “dataline“: “Charge 2 :info: $ 177.850000 $/month” } ] }, |
| Distribution Charges | Collection | Collection of distribution charges |
“Distribution Charges“: { “charges“: [ { “ChargeLabel“: “Total Dist($/kWh)”, “Unit“: “Kilowatt Hours”, “number“: 1, “Breakdown“: [ { “description“: “Dist Cust Charge($/kWh)”, “cost“: 0.021 }, { “description“: “Monthly Adj Clause (MAC) ($/kWh)”, “cost“: 0.00253 }, { “description“: “Monthly Adj Factor (MAC) ($/kWh)”, “cost“: 0.00504 }, { “description“: “Rev Decoupling ($/kWh)”, “cost“: 0.000060 }, { “description“: “Dist System Benefit Charge ($/kWh)”, “cost“: -0.000020 }, { “description“: “Clean Energy Std Supply (CESS)($/kWh)”, “cost“: 0.0052 }, { “description“: “Tax Sur-Credit ($/kwh)”, “cost“: 0.0049 }, { “description“: “EV Make Ready Surcharge ($/kwh)”, “cost“: 0.0 }, { “description“: “Del Rev Surcharge ($/kWh)”, “cost“: 0.0 }, { “description“: “Uncollet Bill Exp ($/kwh)”, “cost“: 0.0 }, { “description“: “Trans Adj ($/kwh)”, “cost“: 0.0 } ], “cost“: 0.03871, “unit“: “$/kWh”, “dataline“: “Charge 1 :info: $ 0.038710 $/kWh” } ] }, |
| Demand Charges | Collection | Collection of demand charges |
“Demand Charges“: { “charges“: [ { “ChargeLabel“: “Statement of Market Supply Charge Demand ($/kWh)Rate D”, “Unit“: “Peak Kilowatts”, “number“: 1, “cost“: 7.97, “unit“: “$/kW”, “dataline“: “Charge 1 :info: $ 7.970000 $/kW” }, { “ChargeLabel“: “Demand Charge($/kW) Rate E”, “Unit“: “Peak Kilowatts”, “number“: 2, “tiers“: [ { “number“: 1, “from“: 0, “to“: 4, “cost“: 0.0, “unit“: “$/kW”, “tierline“: ” Tier 1 :info: From: 000000 To: 000004 0.000000 $/kW” }, { “number“: 2, “from“: 5, “to“: 0, “cost“: 31.13, “unit“: “$/kW”, “tierline“: ” Tier 2 :info: From: 000005 31.130000 $/kW” } ] }, { “ChargeLabel“: “Demand Charge($/kW) Rate F”, “Unit“: “Peak Kilowatts”, “number“: 3, “tiers“: [ { “number“: 1, “from“: 0, “to“: 4, “cost“: 0.0, “unit“: “$/kW”, “tierline“: ” Tier 1 :info: From: 000000 To: 000004 0.000000 $/kW” }, { “number“: 2, “from“: 5, “to“: 0, “cost“: 24.59, “unit“: “$/kW”, “tierline“: ” Tier 2 :info: From: 000005 24.590000 $/kW” } ] }, { “ChargeLabel“: “Dyn Load Mngmt Demand ($/kWh) Rate H”, “Unit“: “Peak Kilowatts”, “number“: 4, “cost“: 0.42, “unit“: “$/kW”, “dataline“: “Charge 4 :info: $ 0.420000 $/kW” }, { “ChargeLabel“: “Statement of EV Make Ready Surcharge ($/kWh)Rate I”, “Unit“: “Peak Kilowatts”, “number“: 5, “cost“: 0.01, “unit“: “$/kW”, “dataline“: “Charge 5 :info: $ 0.010000 $/kW” } ], “tou“: { “Dec WeekDay“: [ [ 3 ], ], “Dec WeekEnd“: [ [ 3 ], ] } }, |
| Energy Charges | Collection | Collection of energy charges |
“Energy Charges“: { “charges“: [ { “ChargeLabel“: “Total Energy ($/kWh)”, “Unit“: “Kilowatt Hours”, “number“: 1, “feedin_rate“: 0.0, “ndx“: true, “cost“: 0.01764, “unit“: “$/kWh”, “dataline“: “Charge 1 :info: $ 0.017640 $/kWh” } ] } |
| notes | String | Distributor’s Description of what type of customer will be assigned this tariff, usually based upon peak or monthly usage and/or residential or commercial | “notes“: “Low Tension Service Light, heat, and power for general uses where the Customer’s initial requirements are expected to be in excess of 10 kilowatts subject to the Common Provisions and Special Provisions of this Service Classification. energy charge is an average estimate as it is not published in the tariff Energy- Market Supply Charge Cap-NYC ($/kwh)-0,0 Energy-Merchant Function Charge ($/kwh)-0,00135 Energy – Adj Factors ($/kwh)-0,0 Total Energy ($/kwh)- from Coose Energy”, |
| url | String |
http://url_link_distributors_doc Link to the overall tariff document |
“url”: “http://url_link_to_distributors_doc” |
Charge Collections
The following table contains data fields that are common among all charge types.
| Field Name | Data Type | Description | Example |
| Unit | String | Basis of the charge (described in our “API Basis” page) | “Unit“: “Fixed”, |
| number | Integer | Used by our UI when viewing a Tariff’s details; Determines the order of the charges | “number“: 1, |
| cost | Float | Total Rate of the charge | “cost“: 220.64, |
| unit | String | Unit of the charge | “unit“: “$/month”, |
| dataline | String | Used by our UI when viewing a Tariff’s details | “dataline“: “Charge 1 :info: $ 220.640000 $/month” |
Distribution Charge Collection
The following table contains data fields that are not common among every charge type.
| Field Name | Data Type | Description | Example |
| ChargeLabel | String | Label of the charge | “ChargeLabel“: “Total Dist($/kWh)”, |
| Breakdown | Collection | Breakdown of charge components |
“Breakdown“: [ { “description“: “Dist Cust Charge($/kWh)”, “cost“: 0.021 }, { “description“: “Monthly Adj Clause (MAC) ($/kWh)”, “cost“: 0.00253 }, { “description“: “Monthly Adj Factor (MAC) ($/kWh)”, “cost“: 0.00504 }, { “description“: “Rev Decoupling ($/kWh)”, “cost“: 0.000060 }, { “description“: “Dist System Benefit Charge ($/kWh)”, “cost“: -0.000020 }, { “description“: “Clean Energy Std Supply (CESS)($/kWh)”, “cost“: 0.0052 }, { “description“: “Tax Sur-Credit ($/kwh)”, “cost“: 0.0049 }, { “description“: “EV Make Ready Surcharge ($/kwh)”, “cost“: 0.0 }, { “description“: “Del Rev Surcharge ($/kWh)”, “cost“: 0.0 }, { “description“: “Uncollet Bill Exp ($/kwh)”, “cost“: 0.0 }, { “description“: “Trans Adj ($/kwh)”, “cost“: 0.0 } ], |
Demand Charge Collection
The following table contains data fields that are not common among every charge type.
|
Field Name |
Data Type |
Description |
Example |
|
ChargeLabel |
String |
Label of the charge |
“ChargeLabel“: “Demand Charge($/kW) Rate E”, |
|
tiers |
Collection |
Collection of charge tiers |
“tiers“: [ { “number“: 1, “from“: 0, “to“: 4, “cost“: 0.0, “unit“: “$/kW”, “tierline“: ” Tier 1 :info: From: 000000 To: 000004 0.000000 $/kW” }, { “number“: 2, “from“: 5, “to“: 0, “cost“: 31.13, “unit“: “$/kW”, “tierline“: ” Tier 2 :info: From: 000005 31.130000 $/kW” } ] |
Energy Charge Collection
The following table contains data fields that are not common among every charge type.
|
Field Name |
Data Type |
Description |
Example |
|
ChargeLabel |
String |
Label of the charge |
“ChargeLabel“: “Total Energy ($/kWh)”, |
|
feedin_rate |
Float |
Feed in rate was introduced for AU Tariffs, this is the energy rate $/kwh at which the User will be credited for excess power injected back into the Grid |
“feedin_rate“: 0.0, |
|
Ndx |
Boolean |
Whether or not this charge is using index pricing; index pricing described in basis |
“ndx“: true, |
Breakdown
This collection contains a list of components that apply to a charge, usually Distribution
|
Field Name |
Data Type |
Description |
Example |
|
description |
String |
Name of the charge component |
“description“: “Dist Cust Charge($/kWh)”, |
|
cost |
Float |
Rate of the component |
“cost“: 0.021 |
Tiers
This collection contains a list of tiers that apply to Tiered charges.
|
Field Name |
Data Type |
Description |
Example |
|
number |
Integer |
Used by our UI when viewing a Tariff’s details |
“number“: 1, |
|
from |
Integer |
Starting amount of the tier in kW |
“from“: 0, |
|
to |
Integer |
Ending amount of the tier in kW |
“to“: 4, |
|
cost |
Float |
Rate of the tier |
“cost“: 0.0, |
|
unit |
String |
Billing unit of the rate |
“unit“: “$/kW”, |
|
tierline |
String |
Used by our UI when viewing a Tariff’s details |
“tierline“: ” Tier 1 :info: From: 000000 To: 000004 0.000000 $/kW” |
Sample Response
Below is a sample of JSON data you may see returned from this endpoint.
[
{
“utility“: “Consolidated Edison Co. Of NY-Zone J”,
“tariff“: “C-9 Gen Serv -Low Tension (NYC Zone J)”,
“effective“: “2023-01-01”,
“revision_reason“: “Effective Date”,
“notes“: “Low Tension Service Light, heat, and power for general uses where the Customer’s initial requirements are expected to be in excess of 10 kilowatts subject to the Common Provisions and Special Provisions of this Service Classification. energy charge is an average estimate as it is not published in the tariff Energy- Market Supply Charge Cap-NYC ($/kwh)-0,0 Energy-Merchant Function Charge ($/kwh)-0,00135 Energy – Adj Factors ($/kwh)-0,0 Total Energy ($/kwh)- from Coose Energy”,
“Monthly Charges“:
{
“charges“:
[
{
“Unit“: “Fixed”,
“number“: 1,
“cost“: 220.64,
“unit“: “$/month”,
“dataline“: “Charge 1 :info: $ 220.640000 $/month”
},
{
“Unit“: “Fixed”,
“number“: 2,
“cost“: 177.85,
“unit“: “$/month”,
“dataline“: “Charge 2 :info: $ 177.850000 $/month”
}
]
},
“Distribution Charges“:
{
“charges“:
[
{
“ChargeLabel“: “Total Dist($/kWh)”,
“Unit“: “Kilowatt Hours”,
“number“: 1,
“Breakdown“:
[
{
“description“: “Dist Cust Charge($/kWh)”,
“cost“: 0.021
},
{
“description“: “Monthly Adj Clause (MAC) ($/kWh)”,
“cost“: 0.00253
},
{
“description“: “Monthly Adj Factor (MAC) ($/kWh)”,
“cost“: 0.00504
},
{
“description“: “Rev Decoupling ($/kWh)”,
“cost“: 0.000060
},
{
“description“: “Dist System Benefit Charge ($/kWh)”,
“cost“: -0.000020
},
{
“description“: “Clean Energy Std Supply (CESS)($/kWh)”,
“cost“: 0.0052
},
{
“description“: “Tax Sur-Credit ($/kwh)”,
“cost“: 0.0049
},
{
“description“: “EV Make Ready Surcharge ($/kwh)”,
“cost“: 0.0
},
{
“description“: “Del Rev Surcharge ($/kWh)”,
“cost“: 0.0
},
{
“description“: “Uncollet Bill Exp ($/kwh)”,
“cost“: 0.0
},
{
“description“: “Trans Adj ($/kwh)”,
“cost“: 0.0
}
],
“cost“: 0.03871,
“unit“: “$/kWh”,
“dataline“: “Charge 1 :info: $ 0.038710 $/kWh”
}
]
},
“Demand Charges“:
{
“charges“:
[
{
“ChargeLabel“: “Statement of Market Supply Charge Demand ($/kWh)Rate D”,
“Unit“: “Peak Kilowatts”,
“number“: 1,
“cost“: 7.97,
“unit“: “$/kW”,
“dataline“: “Charge 1 :info: $ 7.970000 $/kW”
},
{
“ChargeLabel“: “Demand Charge($/kW) Rate E”,
“Unit“: “Peak Kilowatts”,
“number“: 2,
“tiers“:
[
{
“number“: 1,
“from“: 0,
“to“: 4,
“cost“: 0.0,
“unit“: “$/kW”,
“tierline“: ” Tier 1 :info: From: 000000 To: 000004 0.000000 $/kW”
},
{
“number“: 2,
“from“: 5,
“to“: 0,
“cost“: 31.13,
“unit“: “$/kW”,
“tierline“: ” Tier 2 :info: From: 000005 31.130000 $/kW”
}
]
},
{
“ChargeLabel“: “Demand Charge($/kW) Rate F”,
“Unit“: “Peak Kilowatts”,
“number“: 3,
“tiers“:
[
{
“number“: 1,
“from“: 0,
“to“: 4,
“cost“: 0.0,
“unit“: “$/kW”,
“tierline“: ” Tier 1 :info: From: 000000 To: 000004 0.000000 $/kW”
},
{
“number“: 2,
“from“: 5,
“to“: 0,
“cost“: 24.59,
“unit“: “$/kW”,
“tierline“: ” Tier 2 :info: From: 000005 24.590000 $/kW”
}
]
},
{
“ChargeLabel“: “Dyn Load Mngmt Demand ($/kWh) Rate H”,
“Unit“: “Peak Kilowatts”,
“number“: 4,
“cost“: 0.42,
“unit“: “$/kW”,
“dataline“: “Charge 4 :info: $ 0.420000 $/kW”
},
{
“ChargeLabel“: “Statement of EV Make Ready Surcharge ($/kWh)Rate I”,
“Unit“: “Peak Kilowatts”,
“number“: 5,
“cost“: 0.01,
“unit“: “$/kW”,
“dataline“: “Charge 5 :info: $ 0.010000 $/kW”
}
],
“tou“:
{
“Dec WeekDay“:
[
[
3
],
],
“Dec WeekEnd“:
[
[
3
],
]
}
},
“Energy Charges“:
{
“charges“:
[
{
“ChargeLabel“: “Total Energy ($/kWh)”,
“Unit“: “Kilowatt Hours”,
“number“: 1,
“feedin_rate“: 0.0,
“ndx“: true,
“cost“: 0.01764,
“unit“: “$/kWh”,
“dataline“: “Charge 1 :info: $ 0.017640 $/kWh”
}
]
}
}
]
Retrieve Operators
This endpoint returns a list of each of the Independent System Operators (ISOs/Operators) that are in our system.
curl –location –request GET ‘https://map.claritygrid.net/ecservice/api/operators’ \
–header ‘Content-Type: application/json’ \
–header ‘ecservicesessions:
VJk6jTwXqY2Wy44dstway5VkTGX2FUV6PLVC1Bip1Yg67S5cOXn4U1376IePadGD’
| Field Name | Data Type | Description | Example |
| capacity_weight | Integer | RFU | “capacity_weight“: 1, |
| name | String | Common name of the ISO/Operator | “name“: “New England ISO”, |
| iso_prefix | String | Prefix of the ISO/Operator | “iso_prefix“: “neiso”, |
| id | Integer | Unique Clarity Grid ID of the ISO/Operator | “id“: 1 |
Sample Output
Below is a sample of JSON data you may see returned from this endpoint.
Note: The following output has been heavily condensed, and is solely to show the data structure.
[
{
“capacity_weight“: 1,
“name“: “New England ISO”,
“iso_prefix“: “neiso”,
“id“: 1
},
]
