Skip to main content
The electricity rates endpoint surfaces EIA regional average electricity prices sourced from EIA Electric Sales, Revenue, and Average Price Table 4. Records cover national, census division, and state-level aggregations for residential, commercial, and industrial customer classes. These rates are market context for payback modeling and proposal storytelling — they are not customer tariff truth and should not be presented as what a specific customer actually pays. Endpoint 
GET https://homeservicedata.com/api/v1/context/electricity-rates

​
Query Parameters

​
state
string
Two-letter state code (e.g., CA, NY). Returns state-level rate records for that state. Case-insensitive.
​
region_type
string
Filter by geographic aggregation level. One of: national, census_division, state.
​
region_code
string
Specific region code to match. For state records, this is the two-letter state code. For census division records, this is the EIA division code (e.g., pacific, south_atlantic).
​
data_year
integer
Filter to a specific publication year (e.g., 2023). Must be a four-digit integer greater than 2000.
​
include_divisions
boolean
default:"false"
When true, census division records are included alongside state records in the same response.
​
limit
integer
default:"100"
Maximum number of records to return. Capped at 500.

​
Response Fields

​
records
array
Array of regional electricity rate objects.
​
coverage
object
Query summary and dataset attribution.
EIA electricity rate averages are market-level context. They reflect regional averages — not the specific rate plan, time-of-use schedule, or demand charges applicable to any individual customer. Do not present these figures as a customer’s actual electricity cost without supplementing with utility-specific tariff data.
For solar payback calculations, use residential_usd_per_kwh from the state record that matches the job location, paired with the customer’s actual consumption. Cross-reference against the customer’s utility bill for accuracy.

​
Example Request

curl -G https://homeservicedata.com/api/v1/context/electricity-rates \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "state=CA" \
  --data-urlencode "region_type=state" \
  --data-urlencode "data_year=2023"

​
Example Response

{
  "success": true,
  "data": {
    "records": [
      {
        "id": "elr_01hzka1bc2de3fg4hi5jk6qrst",
        "source_document_id": "doc_01hzka1bc2de3fg4hi5jk6eia",
        "region_type": "state",
        "region_code": "CA",
        "state_code": "CA",
        "region_name": "California",
        "data_year": 2023,
        "effective_period": "2023-annual",
        "residential_cents_per_kwh": 29.84,
        "commercial_cents_per_kwh": 22.11,
        "industrial_cents_per_kwh": 15.63,
        "transportation_cents_per_kwh": null,
        "total_cents_per_kwh": 24.52,
        "residential_usd_per_kwh": 0.2984,
        "commercial_usd_per_kwh": 0.2211,
        "industrial_usd_per_kwh": 0.1563,
        "transportation_usd_per_kwh": null,
        "total_usd_per_kwh": 0.2452,
        "source_url": "https://www.eia.gov/electricity/sales_revenue_price/",
        "source_table": "Table 4",
        "last_verified_at": "2024-08-01T00:00:00Z",
        "applicable_trades": ["solar", "hvac", "electrical"],
        "metadata": null,
        "updated_at": "2024-08-15T10:00:00Z"
      }
    ],
    "coverage": {
      "source": "EIA Electric Sales, Revenue, and Average Price Table 4",
      "latest_loaded_year": 2023,
      "regions_returned": 1,
      "quote_safe_only": false,
      "usage_note": "EIA averages are market context only and should not be treated as customer tariff truth."
    }
  }
}