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",
}