Skip to main content
The PowerHQ Plan Data API gives you real-time access to U.S. retail electricity data across every deregulated market PowerHQ supports. With a single GraphQL endpoint you can retrieve residential and business plans, component-level pricing, disclosure documents (EFL, TOS, YRAC, and more), utility (TDU) lookups, and enrollment hand-off URLs. Send a query naming exactly the fields you want; the server returns only those fields as JSON — nothing more, nothing less.

​
Environments

Use the Certification environment while you build and test your integration. Switch to Production when you’re ready to serve live traffic. Both environments require the same authentication credentials.

​
What You Can Query

Residential Plans

Retrieve available retail electricity plans for a residential address, filtered by ZIP code, utility, monthly usage, and price type.

Business Plans

Fetch commercial electricity plans by ZIP code and annual usage, with support for move-in scenarios and custom start dates.

Utilities

Look up the transmission and distribution utility (TDU) that serves a given ZIP code — a required input for plan queries in most markets.

Next Start Date

Get the earliest available service start date for a ZIP code, accounting for move-in rules and market-specific scheduling windows.

Utility Accounts

Validate and retrieve an existing utility account by account number and service address for both residential and business customers.

Energy Info by State

Pull state-level market information — including regulatory context and available rate types — for residential or business segments.

​
Coverage

Examples throughout this documentation use Texas ZIP codes (for example, 75231 and 77002), but the same queries work unchanged across all deregulated markets PowerHQ supports — including Pennsylvania (e.g. 19103), Illinois (e.g. 60602), New Jersey (e.g. 07030), Ohio, and others. Plan availability and supported query parameters vary by market; check the per-query reference pages for market-specific notes.
Your API key is the only credential. Contact your PowerHQ representative for a key, or run real queries with no key at all in the playground. Requests without a valid key are rejected with 403 Forbidden.