Southern California Edison

Southern California Edison (SCE) is a utility covering most of central California.

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.

Data Available

To see what data can be collected for this utility, click here.

Tariffs

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.

#TODO

NOTE: This list of tariffs covers the vast majority of tariffs we see for this utility. However every so often, we see new tariffs that may be included in 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 Bill Block

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`

Example

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
}

SCE Tracked Charges Bill Block

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
`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
}

SCE Details Bill Block

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