Skip to main content

Power your product with real electricity plans

The PowerHQ API gives you programmatic access to live, market-accurate energy plans — residential and business — across the deregulated U.S. markets we support, plus an embedded checkout that runs the regulated enrollment for you. You build the experience; PowerHQ keeps the supplier relationships, pricing, disclosures, and enrollment operations current behind the scenes.

Start here​

  • Quickstart — from a ZIP code to a rendered plan list and an embedded checkout in ~15 minutes.
  • Key concepts — the handful of objects you'll work with: plans, suppliers, utilities, enrollment, disclosures.
  • Authentication — keys, environments, and keeping your key server-side.

Guides​

Task-based walkthroughs for each thing your customers expect from a power shopping experience:

  • Plan shopping — query plans by ZIP, utility, and usage; what each field means.
  • Pricing correctly — advertised vs. all-in, seasonalized pricing, and the per-state differences that trip people up.
  • Showing disclosures — EFL/TOS/YRAC and state equivalents, and the compliance rule for displaying them.
  • Embedded checkout — drop the regulated enrollment flow into your UI with one iframe.
  • Attribution & reporting — how conversions are credited to you, and the reports you'll receive.

Reference & tools​

  • API reference — every query, type, and enum, from the live schema.
  • Example app — a minimal, dependency-free reference integration (server-side proxy + plan UI + embedded checkout). See the powerhq-example-app project.
  • llms.txt — a single file that teaches an AI coding assistant your API. Point Cursor/Copilot/Claude at https://powerhq.co/llms.txt.

The shape of an integration​

  1. Customer enters a ZIP (or you already have it).
  2. Your backend POSTs a residentialPlans (or businessPlans) query with that ZIP.
  3. You render the plans — the all-in rate, term, supplier, and the plan's disclosure documents.
  4. The customer picks a plan; you open its headlessEnrollmentUrl in an embedded checkout iframe.
  5. PowerHQ runs enrollment and reports the conversion back to you, already attributed to your partner code.