1. Documentation
2. Utilities
3. PG&E

Pacific Gas and Electric

Pacific Gas and Electric (PG&E) is a utility covering much of northern California.

Website: https://www.pge.com/

Utility ID: PG&E (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.

PG&E Net Energy Metering Bill Block

PG&E Net Energy Metering (NEM) is a separate billing schedule that makes it easier for PG&E 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.

Example:

// PG&E NEM Bill Block Example
{
    "cumulative_charges": 1.12,
    "cumulative_volume": 100.1,
    "cumulative_unit": "kwh",
    "trueup_estimate": 11.69,
    "trueup_date": "2016-12-28T00:00:00.000000+00:00",
    "is_trueup_bill": true,
    "nem_line_items": [
        {
            "cost": 11.36,
            "end": "2016-01-28T00:00:00.000000+00:00",
            "name": "Peak",
            "rate": 0.17219,
            "start": "2016-01-01T00:00:00.000000+00:00",
            "unit": "kWh",
            "volume": 65.99
        },
        {
            "cost": 36.37,
            "end": "2016-01-28T00:00:00.000000+00:00",
            "name": "Off Peak",
            "rate": 0.15536,
            "start": "2016-01-01T00:00:00.000000+00:00",
            "unit": "kWh",
            "volume": 234.12
        },
        ...
    ]
}

PG&E Details Bill Block

The pge_details block shows information from the top of certain bills that's unique to PG&E and isn't captured elsewhere in the other bill blocks.

Example:

---

PG&E Electric Details Bill Block

PG&E provides an additional bill details document (you may know them as "black and white bills" or "NEM electric statements") for certain services that we sometimes download to get extra information not shown in normal electric bills. This includes things like the underlying tariff for NEM services, energy usage broken down by channel ID, or time of use demand. There's a lot of information in these documents so we've created a special bill block to make it easier for our users to get this data.

Example:

"pge_bill_details": {
        "bill_total": 27.04,
        "current_month_tou_demand": [],
        "energy_charge_summary": [
            {
                "cost": 3.19,
                "name": "Current Unbilled Generation Charge"
            },
            {
                "cost": -99.12,
                "name": "Current Unbilled Generation Credits: Solar"
            },
            {
                "cost": -40.01,
                "name": "Current Unbilled Non-Generation Credit/Charge"
            },
            {
                "cost": 61.74,
                "name": "Total Unbilled Generation Charge"
            },
            {
                "cost": -328.16,
                "name": "Total Unbilled Generation Credits: Solar"
            },
            {
                "cost": -90.52,
                "name": "Total Unbilled Non-Generation Credits/Charges"
            }
        ],
        "meter_information": [
            {
                "channel_id": "1234567890A",
                "unit": "kwh",
                "usage": 7902.0
            },
            {
                "channel_id": "1234567890B",
                "unit": "kwh",
                "usage": -20411.0
            }
        ],
        "net_usage": -12509.0,
        "seasonal_usage": null,
        "trueup_history": [],
        "trueup_summary": [
            {
                "bill_date": "2018-06-01T07:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": -2105.22,
                "total_kWh": -12509.0
            },
            {
                "bill_date": "2018-05-05T07:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": -1202.19,
                "total_kWh": -6201.0
            },
            {
                "bill_date": "2018-04-02T07:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 109.55,
                "total_kWh": 802.0
            },
            {
                "bill_date": "2018-03-01T08:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 215.02,
                "total_kWh": 1304.0
            },
            {
                "bill_date": "2018-02-02T08:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 1702.67,
                "total_kWh": 12022.0
            },
            {
                "bill_date": "2018-01-02T08:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 1825.61,
                "total_kWh": 13105.0
            },
            {
                "bill_date": "2017-12-03T08:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 1602.11,
                "total_kWh": 14418.0
            },
            {
                "bill_date": "2017-11-02T07:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 651.13,
                "total_kWh": 4909.0
            },
            {
                "bill_date": "2017-10-02T07:00:00.000000+00:00",
                "rate_schedule": "A 6 P",
                "total_charges": 407.21,
                "total_kWh": 3991.0
            }
        ]
    },

Energy Charge

Example:

{
        "name": "Current Unbilled Non-Generation Credit/Charge",
        "cost": 3501.88
}

Meter Information Block

Example:

{
    "channel_id": "1234",
    "unit": "kwh",
    "usage": -8237.0
}

Seasonal Usage Block

Example:

{
    "summer": 9405.0,
    "winter": 1951.0
}

Current Month TOU Demand Block

Example:

{
    "season": "summer",
    "tou_period": "part_peak",
    "demand_constant": 100.0,
    "maximum_demand": 207.0
}

Trueup History Block

This block provides the information from the true-up history table found on some bills.

Example:

{
    "bill_date": "2015-11-05T08:00:00.000000+00:00",
    "energy_charges_or_credits": 5107.9,
    "summer_off_peak_kwh": 10411.0,
    "summer_on_peak_kwh": -410.0,
    "summer_part_peak_kwh": 6502.0,
    "winter_off_peak_kwh": 4307.0,
    "winter_on_peak_kwh": null,
    "winter_part_peak_kwh": 3303.0
}

Trueup Summary Block

Example:

{
    "bill_date": "2017-01-01T07:00:00.000000+00:00",
    "rate_schedule": "E10S",
    "total_kWh": 34019.0,
    "total_charges": 8402.18
}

---

PGE Electric Charge Breakdown Bill Block

PG&E includes a breakdown of electric charges on most of their bills. This bill block is not service specific, so it can be found in the utility specific billing summary bill blocks

Example:

{
    "pge_electric_charge_breakdown": [
        {
            "cost": 570.23,
            "name": "Transmission",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 2716.06,
            "name": "Distribution",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 503.12,
            "name": "Electric Public Purpose Programs",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 6.49,
            "name": "Nuclear Decommissioning",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 172.42,
            "name": "DwR Bond Charge",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 78.32,
            "name": "Competition Transition Charges (CTC)",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": -0.68,
            "name": "Energy Cost Recovery Amount",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 578.36,
            "name": "PCIA",
            "rate": null,
            "unit": null,
            "volume": null
        },
        {
            "cost": 21.24,
            "name": "Taxes and Other",
            "rate": null,
            "unit": null,
            "volume": null
        }
    ],
}