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

charges“:

            [

                {

                    “Unit“: “Fixed”,

                    “number“: 1,

                    “cost“: 220.64,

                    “unit“: “$/month”,

                    “dataline“: “Charge 1 [c](tou) :info:    $ 220.640000 $/month”

                },

            ]

Distribution Charges Collection Collection of distribution charges

charges“:

            [

                {

                    “ChargeLabel“: “Total Dist($/kWh)”,

                    “Unit“: “Kilowatt Hours”,

                    “number“: 1,

                    “Breakdown“:

                    [

                        {

                            “description“: “Dist Cust Charge($/kWh)”,

                            “cost“: 0.021

                        },

                    ],

                    “cost“: 0.03871,

                    “unit“: “$/kWh”,

                    “dataline“: “Charge 1 [d] :info:    $ 0.038710 $/kWh”

                }

            ]

Demand Charges Collection Collection of demand charges

Demand Charges“:

        {

            “charges“:

            [

                {

                    “ChargeLabel“: “Demand Charge($/kW) Rate E”,

                    “Unit“: “Peak Kilowatts”,

                    “number“: 2,

                    “dataline“: “Charge 2 [dct](tou) :info: “,

                    “tiers“:

                    [

                        {

                            “number“: 1,

                            “from“: 0,

                            “to“: 4,

                            “cost“: 0.0,

                            “unit“: “$/kW”,

                            “tierline“: ”            Tier 2-1 :info:  From: 000000   To: 000004    0.000000 $/kW”

                        },

                    ]

                },

            ],

            “tou“:

            {

                “Jan WeekDay“:

                [

                    [

                        3

                    ],

                ],

                “Jan WeekEnd“:

                [

                    [

                        3

                    ],

                ],

            }

        },

Energy Charges Collection Collection of energy charges

charges“:

            [

                {

                    “ChargeLabel“: “Total Energy ($/kWh)”,

                    “Unit“: “Kilowatt Hours”,

                    “number“: 1,

                    “feedin_rate“: 0.0,

                    “ndx“: true,

                    “Breakdown“:

                    [

                        {

                            “description“: “Energy-Merchant Function Charge ($/kWh)”,

                            “cost“: 0.00101

                        },

                    ],

                    “cost“: 0.01764,

                    “unit“: “$/kWh”,

                    “dataline“: “Charge 1 [e] :info:    $ 0.017640”

                }

            ]

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_to_distributors_documentation

Link to the overall tariff document

url”: “http://url_link_to_distributors_documentation”

Charge Collections

The following table contains data fields that are common among all charge types.

Field Name Data Type Description Example
ChargeLabel String Label of the charge ChargeLabel“: “Total Dist($/kWh)”,
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 [c](tou) :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
Breakdown Collection Breakdown of charge components

Breakdown“:

                    [

                        {

                            “description“: “Dist Cust Charge($/kWh)”,

                            “cost“: 0.021

                        },

                    ],

Demand Charge Collection

The following table contains data fields that are not common among every charge type.

Field Name Data Type Description Example
tiers Collection Collection of charge tiers

{

                            “number“: 1,

                            “from“: 0,

                            “to“: 4,

                            “cost“: 0.0,

                            “unit“: “$/kW”,

                            “tierline“: ”            Tier 2-1 :info:  From: 000000   To: 000004    0.000000 $/kW”

 },

Energy Charge Collection

The following table contains data fields that are not common among every charge type.

Field Name Data Type Description Example
Breakdown Collection Breakdown of charge components

Breakdown“:

                    [

                        {

                            “description“: “Energy-Merchant Function Charge ($/kWh)”,

                            “cost“: 0.00101

                        },

                    ],

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 and Energy Charges.

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 2-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 [c](tou) :info:    $ 220.640000 $/month”

                },

                {

                    “Unit“: “Fixed”,

                    “number“: 2,

                    “cost“: 177.85,

                    “unit“: “$/month”,

                    “dataline“: “Charge 2 [c](tou) :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 [d] :info:    $ 0.038710 $/kWh”

                }

            ]

        },

        “Demand Charges“:

        {

            “charges“:

            [

                {

                    “ChargeLabel“: “Statement of Market Supply Charge Demand ($/kWh)Rate D”,

                    “Unit“: “Peak Kilowatts”,

                    “number“: 1,

                    “cost“: 2.37,

                    “unit“: “$/kW”,

                    “dataline“: “Charge 1 [dc] :info:    $ 2.370000 $/kW”

                },

                {

                    “ChargeLabel“: “Demand Charge($/kW) Rate E”,

                    “Unit“: “Peak Kilowatts”,

                    “number“: 2,

                    “dataline“: “Charge 2 [dct](tou) :info: “,

                    “tiers“:

                    [

                        {

                            “number“: 1,

                            “from“: 0,

                            “to“: 4,

                            “cost“: 0.0,

                            “unit“: “$/kW”,

                            “tierline“: ”            Tier 2-1 :info:  From: 000000   To: 000004    0.000000 $/kW”

                        },

                        {

                            “number“: 2,

                            “from“: 5,

                            “to“: 0,

                            “cost“: 31.13,

                            “unit“: “$/kW”,

                            “tierline“: ”            Tier 2-2 :info:  From: 000005                           31.130000 $/kW”

                        }

                    ]

                },

                {

                    “ChargeLabel“: “Demand Charge($/kW) Rate F”,

                    “Unit“: “Peak Kilowatts”,

                    “number“: 3,

                    “dataline“: “Charge 3 [dct](tou) :info: “,

                    “tiers“:

                    [

                        {

                            “number“: 1,

                            “from“: 0,

                            “to“: 4,

                            “cost“: 0.0,

                            “unit“: “$/kW”,

                            “tierline“: ”            Tier 3-1 :info:  From: 000000   To: 000004    0.000000 $/kW”

                        },

                        {

                            “number“: 2,

                            “from“: 5,

                            “to“: 0,

                            “cost“: 24.59,

                            “unit“: “$/kW”,

                            “tierline“: ”            Tier 3-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 [dc] :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 [dc] :info:    $ 0.010000 $/kW”

                }

            ],

            “tou“:

            {

                “Jan WeekDay“:

                [

                    [

                        3

                    ],

                ],

                “Jan WeekEnd“:

                [

                    [

                        3

                    ],

                ],

            }

        },

        “Energy Charges“:

        {

            “charges“:

            [

                {

                    “ChargeLabel“: “Total Energy ($/kWh)”,

                    “Unit“: “Kilowatt Hours”,

                    “number“: 1,

                    “feedin_rate“: 0.0,

                    “ndx“: true,

                    “Breakdown“:

                    [

                        {

                            “description“: “Energy-Merchant Function Charge ($/kWh)”,

                            “cost“: 0.00101

                        },

                        {

                            “description“: “MSC I (Monthly)($/kWh)-NYC”,

                            “cost“: -0.00238

                        },

                        {

                            “description“: “MSC II(Monthly) ($/kWh)-NYC”,

                            “cost“: 0.01392

                        },

                        {

                            “description“: “Clean Energy Supply-RECs ($/kwh)”,

                            “cost“: 0.00126

                        },

                        {

                            “description“: “Clean Energy Supply-Zero Emissions ($/kwh)”,

                            “cost“: 0.00376

                        },

                        {

                            “description“: “Clean Energy Supply-Offshore Wind ($/kwh)”,

                            “cost“: 0.0

                        },

                        {

                            “description“: “Clean Energy Supply-R Value($/kwh)”,

                            “cost“: 0.000070

                        },

                        {

                            “description“: “Energy PPA ($/kWh)”,

                            “cost“: 0.0

                        },

                        {

                            “description“: “Energy ($/kwh) (4/20-3/31)”,

                            “cost“: 0.0

                        }

                    ],

                    “cost“: 0.01764,

                    “unit“: “$/kWh”,

                    “dataline“: “Charge 1 [e] :info:    $ 0.017640”

                }

            ]

        }

    },

]

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

  },

]