Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.
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.org/api/v1/context/electricity-rates
Query Parameters
string
Two-letter state code (e.g., CA, NY). Returns state-level rate records for that state. Case-insensitive.
string
Filter by geographic aggregation level. One of: national, census_division, state.
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).
integer
Filter to a specific publication year (e.g., 2023). Must be a four-digit integer greater than 2000.
boolean
default:"false"
When true, census division records are included alongside state records in the same response.
integer
default:"100"
Maximum number of records to return. Capped at 500.
Response Fields
array
Array of regional electricity rate objects.
Show Record fields
string
Unique record identifier.
string | null
Internal reference to the source document.
string
Aggregation level: national, census_division, or state.
string | null
Region identifier code.
string | null
Two-letter state code (populated for state records).
string
Human-readable region name (e.g., California, Pacific Division).
integer
Calendar year the EIA data represents.
string | null
Effective period label (e.g., 2023-annual).
number | null
Average residential rate in cents per kWh.
number | null
Average commercial rate in cents per kWh.
number | null
Average industrial rate in cents per kWh.
number | null
Average transportation sector rate in cents per kWh.
number | null
All-sector average rate in cents per kWh.
number | null
Residential rate in USD per kWh (decimal form of residential_cents_per_kwh / 100).
number | null
Commercial rate in USD per kWh.
number | null
Industrial rate in USD per kWh.
number | null
Transportation rate in USD per kWh.
number | null
All-sector average rate in USD per kWh.
string | null
URL to the EIA source table.
string | null
EIA source table identifier.
string | null
ISO 8601 timestamp of last data verification.
array
List of trade verticals for which this rate context is relevant (e.g., ["solar", "hvac"]).
object | null
Additional source-specific key-value pairs.
string | null
ISO 8601 timestamp of last record update.
object
Query summary and dataset attribution.
Show Coverage fields
string
Dataset source: EIA Electric Sales, Revenue, and Average Price Table 4.
integer | null
Most recent data year present in the returned records.
integer
Number of records returned.
boolean
Always false — EIA averages are market context only.
string
Reminder that EIA averages are market context and not customer tariff truth.
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.
{ "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." } }}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Home Service Data","colors":{"primary":"#0404d3","light":"#00c4ff","dark":"#0000ff"},"logo":{"light":"https://mintcdn.com/homeservicedata/JjoP8fEv75eQ4FxE/images/HSDLogoblack.svg?fit=max\u0026auto=format\u0026n=JjoP8fEv75eQ4FxE\u0026q=85\u0026s=246cae9ea242485a63a22b0862316e9d","dark":"https://mintcdn.com/homeservicedata/JjoP8fEv75eQ4FxE/images/HSDLogo.svg?fit=max\u0026auto=format\u0026n=JjoP8fEv75eQ4FxE\u0026q=85\u0026s=24f9aee0ed316e0c113cc950c50b7e6d"},"favicon":{"light":"https://mintcdn.com/homeservicedata/wDTFc_5oFbfhApNn/images/apple-touch-icon.png?fit=max\u0026auto=format\u0026n=wDTFc_5oFbfhApNn\u0026q=85\u0026s=91ac30791a0d7ef96d35516e2dd15849","dark":"https://mintcdn.com/homeservicedata/wDTFc_5oFbfhApNn/images/apple-touch-icon.png?fit=max\u0026auto=format\u0026n=wDTFc_5oFbfhApNn\u0026q=85\u0026s=91ac30791a0d7ef96d35516e2dd15849"},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://homeservicedata.org/contact","label":"Request Access"}],"primary":{"type":"button","label":"Dashboard","href":"https://homeservicedata.org/dashboard"}},"footer":{"socials":{}},"fonts":{"heading":{"family":"Instrument Sans","weight":400},"body":{"family":"Inter"}},"icons":{"library":"fontawesome"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"homeservicedata","hasAudioNarration":false,"actualSubdomain":"homeservicedata","customDomains":["docs.homeservicedata.org"],"gitSource":{"type":"github","owner":"lawrencecirillo","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95a3849f23bb02faadf7c:success","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Context Datasets","count":9},{"language":"default","tag":"Dashboard","count":5},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Finance","count":4},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Equipment \u0026 Hardware","count":2},{"language":"default","tag":"Search \u0026 Catalog","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/context-electricity-rates","slug":"/api-reference/context-electricity-rates","pageMetadata":{"title":"GET /api/v1/context/electricity-rates — EIA Rates","sidebarTitle":"Electricity Rates","description":"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.","href":"/api-reference/context-electricity-rates"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,ParamField,ResponseField,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`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 `,_jsx(_components.strong,{children:`not`}),` customer tariff truth and should not be presented as what a specific customer actually pays.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Endpoint`})}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET https://homeservicedata.org/api/v1/context/electricity-rates`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`state`,type:`string`,id:`param-state`,children:_jsxs(_components.p,{children:[`Two-letter state code (e.g., `,_jsx(_components.code,{children:`CA`}),`, `,_jsx(_components.code,{children:`NY`}),`). Returns state-level rate records for that state. Case-insensitive.`]})}),`\n`,_jsx(ParamField,{query:`region_type`,type:`string`,id:`param-region-type`,children:_jsxs(_components.p,{children:[`Filter by geographic aggregation level. One of: `,_jsx(_components.code,{children:`national`}),`, `,_jsx(_components.code,{children:`census_division`}),`, `,_jsx(_components.code,{children:`state`}),`.`]})}),`\n`,_jsx(ParamField,{query:`region_code`,type:`string`,id:`param-region-code`,children:_jsxs(_components.p,{children:[`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., `,_jsx(_components.code,{children:`pacific`}),`, `,_jsx(_components.code,{children:`south_atlantic`}),`).`]})}),`\n`,_jsx(ParamField,{query:`data_year`,type:`integer`,id:`param-data-year`,children:_jsxs(_components.p,{children:[`Filter to a specific publication year (e.g., `,_jsx(_components.code,{children:`2023`}),`). Must be a four-digit integer greater than `,_jsx(_components.code,{children:`2000`}),`.`]})}),`\n`,_jsx(ParamField,{query:`include_divisions`,type:`boolean`,default:`false`,id:`param-include-divisions`,children:_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`true`}),`, census division records are included alongside state records in the same response.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`100`,id:`param-limit`,children:_jsxs(_components.p,{children:[`Maximum number of records to return. Capped at `,_jsx(_components.code,{children:`500`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(ResponseField,{name:`records`,type:`array`,id:`param-records`,children:[_jsx(_components.p,{children:`Array of regional electricity rate objects.`}),_jsxs(Expandable,{title:`Record fields`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:`Unique record identifier.`}),_jsx(ResponseField,{name:`source_document_id`,type:`string | null`,id:`param-source-document-id`,children:`Internal reference to the source document.`}),_jsxs(ResponseField,{name:`region_type`,type:`string`,id:`param-region-type-1`,children:[`Aggregation level: `,_jsx(_components.code,{children:`national`}),`, `,_jsx(_components.code,{children:`census_division`}),`, or `,_jsx(_components.code,{children:`state`}),`.`]}),_jsx(ResponseField,{name:`region_code`,type:`string | null`,id:`param-region-code-1`,children:`Region identifier code.`}),_jsxs(ResponseField,{name:`state_code`,type:`string | null`,id:`param-state-code`,children:[`Two-letter state code (populated for `,_jsx(_components.code,{children:`state`}),` records).`]}),_jsxs(ResponseField,{name:`region_name`,type:`string`,id:`param-region-name`,children:[`Human-readable region name (e.g., `,_jsx(_components.code,{children:`California`}),`, `,_jsx(_components.code,{children:`Pacific Division`}),`).`]}),_jsx(ResponseField,{name:`data_year`,type:`integer`,id:`param-data-year-1`,children:`Calendar year the EIA data represents.`}),_jsxs(ResponseField,{name:`effective_period`,type:`string | null`,id:`param-effective-period`,children:[`Effective period label (e.g., `,_jsx(_components.code,{children:`2023-annual`}),`).`]}),_jsx(ResponseField,{name:`residential_cents_per_kwh`,type:`number | null`,id:`param-residential-cents-per-kwh`,children:`Average residential rate in cents per kWh.`}),_jsx(ResponseField,{name:`commercial_cents_per_kwh`,type:`number | null`,id:`param-commercial-cents-per-kwh`,children:`Average commercial rate in cents per kWh.`}),_jsx(ResponseField,{name:`industrial_cents_per_kwh`,type:`number | null`,id:`param-industrial-cents-per-kwh`,children:`Average industrial rate in cents per kWh.`}),_jsx(ResponseField,{name:`transportation_cents_per_kwh`,type:`number | null`,id:`param-transportation-cents-per-kwh`,children:`Average transportation sector rate in cents per kWh.`}),_jsx(ResponseField,{name:`total_cents_per_kwh`,type:`number | null`,id:`param-total-cents-per-kwh`,children:`All-sector average rate in cents per kWh.`}),_jsxs(ResponseField,{name:`residential_usd_per_kwh`,type:`number | null`,id:`param-residential-usd-per-kwh`,children:[`Residential rate in USD per kWh (decimal form of `,_jsx(_components.code,{children:`residential_cents_per_kwh / 100`}),`).`]}),_jsx(ResponseField,{name:`commercial_usd_per_kwh`,type:`number | null`,id:`param-commercial-usd-per-kwh`,children:`Commercial rate in USD per kWh.`}),_jsx(ResponseField,{name:`industrial_usd_per_kwh`,type:`number | null`,id:`param-industrial-usd-per-kwh`,children:`Industrial rate in USD per kWh.`}),_jsx(ResponseField,{name:`transportation_usd_per_kwh`,type:`number | null`,id:`param-transportation-usd-per-kwh`,children:`Transportation rate in USD per kWh.`}),_jsx(ResponseField,{name:`total_usd_per_kwh`,type:`number | null`,id:`param-total-usd-per-kwh`,children:`All-sector average rate in USD per kWh.`}),_jsx(ResponseField,{name:`source_url`,type:`string | null`,id:`param-source-url`,children:`URL to the EIA source table.`}),_jsx(ResponseField,{name:`source_table`,type:`string | null`,id:`param-source-table`,children:`EIA source table identifier.`}),_jsx(ResponseField,{name:`last_verified_at`,type:`string | null`,id:`param-last-verified-at`,children:`ISO 8601 timestamp of last data verification.`}),_jsxs(ResponseField,{name:`applicable_trades`,type:`array`,id:`param-applicable-trades`,children:[`List of trade verticals for which this rate context is relevant (e.g., `,_jsx(_components.code,{children:`[\"solar\", \"hvac\"]`}),`).`]}),_jsx(ResponseField,{name:`metadata`,type:`object | null`,id:`param-metadata`,children:`Additional source-specific key-value pairs.`}),_jsx(ResponseField,{name:`updated_at`,type:`string | null`,id:`param-updated-at`,children:`ISO 8601 timestamp of last record update.`})]})]}),`\n`,_jsxs(ResponseField,{name:`coverage`,type:`object`,id:`param-coverage`,children:[_jsx(_components.p,{children:`Query summary and dataset attribution.`}),_jsxs(Expandable,{title:`Coverage fields`,children:[_jsxs(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:[`Dataset source: `,_jsx(_components.code,{children:`EIA Electric Sales, Revenue, and Average Price Table 4`}),`.`]}),_jsx(ResponseField,{name:`latest_loaded_year`,type:`integer | null`,id:`param-latest-loaded-year`,children:`Most recent data year present in the returned records.`}),_jsx(ResponseField,{name:`regions_returned`,type:`integer`,id:`param-regions-returned`,children:`Number of records returned.`}),_jsxs(ResponseField,{name:`quote_safe_only`,type:`boolean`,id:`param-quote-safe-only`,children:[`Always `,_jsx(_components.code,{children:`false`}),` — EIA averages are market context only.`]}),_jsx(ResponseField,{name:`usage_note`,type:`string`,id:`param-usage-note`,children:`Reminder that EIA averages are market context and not customer tariff truth.`})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`For solar payback calculations, use `,_jsx(_components.code,{children:`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.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example Request`}),`\n`,_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://homeservicedata.org/api/v1/context/electricity-rates`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"state=CA\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"region_type=state\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data_year=2023\"`})]}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`40`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`40`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"elr_01hzka1bc2de3fg4hi5jk6qrst\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_document_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"doc_01hzka1bc2de3fg4hi5jk6eia\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"region_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"region_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"region_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"California\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data_year\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2023`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"effective_period\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2023-annual\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"residential_cents_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`29.84`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"commercial_cents_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`22.11`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"industrial_cents_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15.63`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"transportation_cents_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_cents_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24.52`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"residential_usd_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.2984`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"commercial_usd_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.2211`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"industrial_usd_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.1563`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"transportation_usd_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_usd_per_kwh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.2452`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://www.eia.gov/electricity/sales_revenue_price/\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_table\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Table 4\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_verified_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-08-01T00:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"applicable_trades\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"solar\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hvac\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"electrical\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"metadata\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-08-15T10:00:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"coverage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EIA Electric Sales, Revenue, and Average Price Table 4\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"latest_loaded_year\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2023`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"regions_returned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quote_safe_only\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage_note\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EIA averages are market context only and should not be treated as customer tariff truth.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"GET /api/v1/context/electricity-rates — EIA Rates","sidebarTitle":"Electricity Rates","description":"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.","href":"/api-reference/context-electricity-rates"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[]},{"title":"Example Request","slug":"example-request","depth":2,"children":[]},{"title":"Example Response","slug":"example-response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"homeservicedata","siteName":"Home Service Data","title":"GET /api/v1/context/electricity-rates — EIA Rates - Home Service Data","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-02T14:46:17.665Z","originalFileLocation":"api-reference/context-electricity-rates.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Home Service Data\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GET /api/v1/context/electricity-rates — EIA Rates - Home Service Data\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Home Service Data\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://homeservicedata.mintlify.site/docs/_mintlify/api/og/v2?division=Context+Datasets\u0026amp;title=GET+%2Fapi%2Fv1%2Fcontext%2Felectricity-rates+%E2%80%94+EIA+Rates\u0026amp;description=Retrieve+EIA+regional+electricity+rate+averages+by+state%2C+census+division%2C+or+national+scope+for+market+context+in+solar%2C+HVAC%2C+and+electrification+quotes.\u0026amp;theme=7c8dcc67965654f8929910a3\u0026amp;signature=04c94ac52daaa1797a1e7397dee9515c49ba0663ee6615a75a16a887bfe63530\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"GET /api/v1/context/electricity-rates — EIA Rates - Home Service Data\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://homeservicedata.mintlify.site/docs/_mintlify/api/og/v2?division=Context+Datasets\u0026amp;title=GET+%2Fapi%2Fv1%2Fcontext%2Felectricity-rates+%E2%80%94+EIA+Rates\u0026amp;description=Retrieve+EIA+regional+electricity+rate+averages+by+state%2C+census+division%2C+or+national+scope+for+market+context+in+solar%2C+HVAC%2C+and+electrification+quotes.\u0026amp;theme=7c8dcc67965654f8929910a3\u0026amp;signature=04c94ac52daaa1797a1e7397dee9515c49ba0663ee6615a75a16a887bfe63530\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/homeservicedata/hCHclyFyxN-aAzaI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Home Service Data\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0404d3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/context-electricity-rates.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.homeservicedata.org/#organization\",\"name\":\"Home Service Data\",\"url\":\"https://docs.homeservicedata.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/homeservicedata/JjoP8fEv75eQ4FxE/images/HSDLogoblack.svg?fit=max\u0026auto=format\u0026n=JjoP8fEv75eQ4FxE\u0026q=85\u0026s=246cae9ea242485a63a22b0862316e9d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.homeservicedata.org/docs#website\",\"name\":\"Home Service Data\",\"url\":\"https://docs.homeservicedata.org/docs\",\"publisher\":{\"@id\":\"https://docs.homeservicedata.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates#webpage\",\"url\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates\",\"name\":\"GET /api/v1/context/electricity-rates — EIA Rates\",\"description\":\"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.\",\"dateModified\":\"2026-07-02T14:46:17.665Z\",\"isPartOf\":{\"@id\":\"https://docs.homeservicedata.org/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Context Datasets\",\"item\":\"https://docs.homeservicedata.org/docs/api-reference/context-hvac\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GET /api/v1/context/electricity-rates — EIA Rates\",\"item\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates#article\",\"headline\":\"GET /api/v1/context/electricity-rates — EIA Rates\",\"name\":\"GET /api/v1/context/electricity-rates — EIA Rates\",\"description\":\"Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.\",\"url\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates\",\"mainEntityOfPage\":{\"@id\":\"https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates#webpage\"},\"dateModified\":\"2026-07-02T14:46:17.665Z\",\"publisher\":{\"@id\":\"https://docs.homeservicedata.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.homeservicedata.org/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Home Service Data\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Home Service Data\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/context-electricity-rates.md","siteName":"Home Service Data","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Home Service Data REST API Overview","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"API Error Codes and How to Handle Them","sidebarTitle":"Errors","href":"/api-reference/errors"}]},{"group":"Search \u0026 Catalog","pages":[{"title":"GET /api/v1/search — Search Across All Datasets","sidebarTitle":"Search","href":"/api-reference/search"},{"title":"GET /api/v1/catalog/equipment — Equipment Catalog","sidebarTitle":"Equipment Catalog","href":"/api-reference/catalog-equipment"}]},{"group":"Finance","pages":[{"title":"GET /api/v1/finance/fees — Dealer Fee Records","sidebarTitle":"Finance Fees","href":"/api-reference/finance-fees"},{"title":"GET /api/v1/context/finance-products — Lender Context","sidebarTitle":"Finance Products","href":"/api-reference/finance-products"},{"title":"GET /api/v1/context/finance-eligibility — Eligibility Records","sidebarTitle":"Finance Eligibility","href":"/api-reference/finance-eligibility"},{"title":"GET /api/v1/pricing/finance — Finance Pricing Context","sidebarTitle":"Finance Pricing","href":"/api-reference/finance-pricing"}]},{"group":"Equipment \u0026 Hardware","pages":[{"title":"GET /api/v1/hardware/inverters — Solar Inverter Data","sidebarTitle":"Inverters","href":"/api-reference/hardware-inverters"},{"title":"GET /api/v1/benchmarks — Market Pricing Benchmarks","sidebarTitle":"Benchmarks","href":"/api-reference/benchmarks"}]},{"group":"Context Datasets","pages":[{"title":"GET /api/v1/context/hvac/pricing — Equipment Prices","sidebarTitle":"HVAC Pricing","href":"/api-reference/context-hvac"},{"title":"GET /api/v1/context/incentives — Program Incentives","sidebarTitle":"Incentives","href":"/api-reference/context-incentives"},{"title":"GET /api/v1/context/climate — County Climate Data","sidebarTitle":"Climate","href":"/api-reference/context-climate"},{"title":"GET /api/v1/context/utility-territory — Lookup API","sidebarTitle":"Utility Territory","description":"Browse utility service territories by state, city, or coordinates, or resolve a postal address to candidate utility territories with confidence and quote-safe flags.","href":"/api-reference/context-utility-territory"},{"title":"GET /api/v1/context/electricity-rates — EIA Rates","sidebarTitle":"Electricity Rates","href":"/api-reference/context-electricity-rates"},{"title":"GET /api/v1/context/labor — Labor Rates and Adders","sidebarTitle":"Labor","description":"Access BLS OEWS regional wage data by trade and occupation code, plus per-task labor adder ranges for HVAC, roofing, solar, and other home-service trades.","href":"/api-reference/context-labor"},{"title":"GET /api/v1/context/permits — Permit Requirements","sidebarTitle":"Permits","href":"/api-reference/context-permits"},{"title":"GET /api/v1/context/roofing — Materials and Labor","sidebarTitle":"Roofing","href":"/api-reference/context-roofing"},{"title":"GET /api/v1/context/ahri-matches — System Ratings","sidebarTitle":"AHRI Matches","href":"/api-reference/context-ahri"}]},{"group":"Composite","pages":[{"title":"GET /api/v1/quote-context — Bundled Quote Context","sidebarTitle":"Quote Context","href":"/api-reference/quote-context"}]},{"group":"Sync","pages":[{"title":"GET /api/v1/sync/snapshot — Full Dataset Snapshot","sidebarTitle":"Sync Snapshot","href":"/api-reference/sync-snapshot"},{"title":"GET /api/v1/sync/changes — Incremental Dataset Changes","sidebarTitle":"Sync Changes","href":"/api-reference/sync-changes"}]}]}]},"basePath":"","title":"GET /api/v1/context/electricity-rates — EIA Rates - Home Service Data","buildId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","deploymentId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","dynamics":[],"chunks":[]}