Southern California Edison (SCE) is a utility covering most of central California.
Website: https://www.sce.com/
Utility ID:
SCE
(this is the utility identifier you use in our API)
The documentation on this page covers the unique data and behavior you will see for this utility. Usually, each section is linked directly from elsewhere in the documentation, so you don't have to read through everything on this page unless it is relevant to you from elsewhere in the docs.
To see what data can be collected for this utility, click here.
Below are the list of tariffs you will likely see in
Base Meter Block
service_tariff
and
Base Bill Block
service_tariff
values for this utility. You can also programmatically download this list of tariffs on the
GET
/files/known_tariffs_json
endpoint. We update this list regularly as we see new tariffs.
service_tariff
values before we can update this list.
So, please be able to handle unexpected tariff names that are not in this list.
SCE Net Energy Metering (NEM) is a separate billing schedule that makes it easier for SCE to charge for any type of system that may feed energy back into the grid. Net Metering means that you get charged or credited based on whether a meter consumes or provides energy to the grid. A trueup is run every year to balance out the amount paid versus the value delivered to the grid. Given that billing structure, we provide a NEM Bill Block that gives you information on the status of charges throughout the year.
Attribute | Format | Description | Example | Gotchas |
---|---|---|---|---|
total_forward |
Float or
null
|
The aggregate kWh flowing into the residence or business during this billing period | 182.0 |
SCE doesn't always include a total_forward value (in which case it will be
null ) but it can be calculated by adding the net_usage and
total_reverse values.
|
total_reverse |
Float | The aggregate kWh flowing out of the residence or business during this billing period | 643.0 |
|
net_usage |
Float | The net total_forward_kwh - total_reverse_kwh | -461.0 |
|
current_nem_month |
String | The current NEM month number | "12" |
|
current_month_generation_credit |
Float | The generation credit earned for the current NEM month | 604.71 |
|
ytd_generation_credit |
Float | The year-to-date NEM credit accumulated for this meter | 0.0 |
|
ytd_generation_charges |
Float | The year-to-date NEM charges accumulated for this meter | 19103.98 |
|
ytd_kwh |
Float | The year-to-date usage in kWh | 107633.0 |
The information for this bill block is pulled from two areas of the bill - the meter readings table usually found on the first page and the "Additional information" box on the tracked charges page.
// SCE NEM Bill Block Example { "current_month_generation_credit": -112.09, "current_nem_month": "6", "net_usage": -1905.0, "total_forward": 15200.0, "total_reverse": 17105.0, "ytd_generation_charges": 8108.21, "ytd_generation_credit": -946.82, "ytd_kwh": 137721.0 }
The values in the sce_tracked_charges
block come from the section
of the bill labelled "Details of your tracked charges." This section may not be
provided on all bills so this block may not always be present in the API response.
Attribute | Format | Description | Example | Gotchas |
---|---|---|---|---|
line_items |
List(Line Item) | A list of the line items from the tracked charges section. | [{"name": "DWR Bond Charge", ...}, ...] |
|
total_cost |
Float | The total cost of all of the tracked charges included on this bill | 2904.19 |
|
Extensible: We may extend this object type in the future, so be able to handle unknown attributes gracefully. |
Example:
// SCE Tracked Charges Bill Block example { "line_items": [ { "cost": 305.21, "end": "2014-02-01T07:00:00.000000+00:00", "name": "Delivery - Energy-Winter Mid peak", "rate": 0.02751, "start": "2014-01-01T07:00:00.000000+00:00", "unit": "kwh", "volume": 11095.0, }, { "cost": 291.74, "end": "2014-02-01T07:00:00.000000+00:00", "name": "Delivery - Energy-Winter Off peak", "rate": 0.01741, "start": "2014-01-01T07:00:00.000000+00:00", "unit": "kwh", "volume": 16757.0, }, { "cost": 136.75, "end": "2014-02-01T07:00:00.000000+00:00", "name": "Delivery - DWR bond charge", "rate": 0.00491, "start": "2014-01-01T07:00:00.000000+00:00", "unit": "kwh", "volume": 27852.0, }, { "cost": 792.74, "end": "2014-02-01T07:00:00.000000+00:00", "name": "Generation - Energy-Winter Mid peak", "rate": 0.07145, "start": "2014-01-01T07:00:00.000000+00:00", "unit": "kwh", "volume": 11095.0, }, { "cost": 807.52, "end": "2014-02-01T07:00:00.000000+00:00", "name": "Generation - Energy-Winter Off peak", "rate": 0.04819, "start": "2014-01-01T07:00:00.000000+00:00", "unit": "kwh", "volume": 16757.0, } ], "total_cost": 2333.96 }
Documentation for the sce_details
bill_block. Currently, we only support voltage level.
Attribute | Format | Description | Example | Gotchas |
---|---|---|---|---|
voltage |
String or
null
|
The voltage that SCE reports for the service. This can be null if the voltage is not reported on the bill or if you activated your meter prior to June 1st, 2017. In that case, you can try refreshing
|
"480" |
|
Extensible: We may extend this object type in the future, so be able to handle unknown attributes gracefully. |
Example:
// SCE Details Bill Block example { "voltage": "480", }
Charge breakdown items are individual items found in a charge breakdown.
Attribute | Format | Description | Example | Notes |
---|---|---|---|---|
name |
String | The name for the charge breakdown item. | "nuclear decommissioning charges" |
|
cost |
Float or
null
|
The amount charged for the charge breakdown item. A negative value
indicates that this item is a credit. A null
indicates that this item doesn't have a charge (e.g.
it's some other non-charged or informative charge breakdown item).
|
-10.02 |
|
date |
ISO8601 or
null
|
The date specified for an item. A null value indicates there is no date available for the item.
|
"2016-01-01T00:00:00-07:00" |
|
volume |
Float or
null
|
The quantity of unit measured for this breakdown item. A null
indicates that this breakdown item doesn't have a volume.
|
12000.0 |
|
unit |
String or
null
|
The unit associated with the breakdown item. A null indicates that this breakdown item doesn't have a unit.
|
"volts" |
|
Extensible: We may extend this object type in the future, so be able to handle unknown attributes gracefully. |
The values in the sce_charge_breakdown
include information regarding the charges for a specific bill.
The bill blocks come from the sections found to the right of the "Details of your new charges" section for each bill.
This section, or any of its subsections, may not be provided on all bills, so they may not always be present in the API.
response.
Attribute | Format | Description | Example | Gotchas |
---|---|---|---|---|
delivery_charges |
List(Charge Breakdown Item) | A list of charge breakdown items found in the delivery charges section. | [{"cost": 82.14, "date": null, "name": "transmission charges", "volume": null, "unit": null}, ...] |
|
generation_charges |
List(Charge Breakdown Item) | A list of charge breakdown items found in the generation charges section. | [{"cost": -0.64, "date": null, "name": "competition transition charge", "volume": null, "unit": null}, ...] |
|
participation_charges |
List(Charge Breakdown Item) | A list of charge breakdown items found in the participation charges section. | [{"cost": null, "date": "10/01/21", "name": "Bill protection start date", "volume": null, "unit": null}, ...] |
|
overall_energy_charges |
List(Charge Breakdown Item) | A list of charge breakdown items found in the overall energy charges section. | [{"cost": 12.23, "date": null, "name": "franchise fees", "volume": null, "unit": null}, ...] |
|
additional_info |
List(Charge Breakdown Item) | A list of charge breakdown items found in the additional information section. | [{"cost": null, "date": null, "name": "Service voltage", "volume": null, "unit": null}, ...] |
|
Extensible: We may extend this object type in the future, so be able to handle unknown attributes gracefully. |
{ "sce_charge_breakdown": { "additional_information": [ { "cost": null, "name": "Service voltage", "value": "210 volts" } ], "delivery_charges": [ { "cost": 82.14, "name": "transmission charges", "value": null }, { "cost": 423.12, "name": "distribution charges", "value": null }, { "cost": 0.49, "name": "nuclear decommissioning charges", "value": null }, { "cost": 97.56, "name": "public purpose programs charge", "value": null }, { "cost": 49.73, "name": "new system generation charge", "value": null } ], "generation_charges": [ { "cost": -0.64, "name": "competition transition charge", "value": null }, { "cost": 87.25, "name": "power charge indifference adjustment (PCIA)", "value": null } ], "overall_energy_charges": [ { "cost": 12.23, "name": "franchise fees", "value": null } ], "participation_charges": [ { "cost": null, "name": "Bill protection start date", "value": "10/01/21" }, { "cost": -173.83, "name": "YTD incentives", "value": null }, { "cost": 124.0, "name": "YTD event charges", "value": null } ] } }