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

  },

]