Southern California Edison

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.

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.

Example NEM meter readings Example NEM info box
// 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.
// 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.
// 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.
Example Charge Breakdown section 1/2 Example Charge Breakdown section 2/2
{
    "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
            }
        ]
    }
}