# PowerHQ > PowerHQ is the infrastructure layer for U.S. retail energy commerce. It gives partners, developers, and retail energy providers one integration point for electricity plan data, pricing, enrollment, and regulatory compliance across deregulated markets. PowerHQ is a B2B platform; it does not sell electricity to consumers. PowerHQ is operated by EnergyBot, Inc. and built by the team behind EnergyBot (energybot.com), a consumer electricity marketplace that has run on this same infrastructure for eight years. PowerHQ packages that backend for external use. **Entity disambiguation:** This file describes PowerHQ at powerhq.co, a U.S. retail energy commerce platform. It is unrelated to any similarly named power tools, hardware, fitness, or IT service brand. The canonical host for this site is `www.powerhq.co`. The PowerHQ API Documentation lives on a separate host, `docs.powerhq.co`. ## What PowerHQ Is and Is Not - **Is:** a B2B infrastructure and API platform for retail electricity commerce. - **Is:** the backend behind EnergyBot, offered to third parties. - **Is not:** a consumer site. Consumers who want to compare and buy an electricity plan should use https://www.energybot.com/ instead. - **Is not:** a utility, a retail electric provider (REP), or a transmission and distribution utility (TDU). - **Is not:** a lead-generation or data-broker business. PowerHQ processes enrollments end to end and owns eSign, credit evaluation, and fulfillment. ## Who PowerHQ Is For - **Channel partners** with audiences who need electricity: comparison sites, moving companies, mortgage and real estate platforms, fintech and bill-reduction apps, property managers, solar installers, cost-optimization tools. - **Developers and product teams** building energy-aware applications who need live plan and pricing data. - **Retail energy providers** seeking broader digital distribution, or a Provider Storefront on their own domain. - **Energy brokers** managing quoting, comparison, and renewals. ## Core Products - **Drop-in Storefront**: PowerHQ's full shopping and enrollment experience running inside a page on the partner's site, shipped as a single iframe. No developer required; the docs compare it to embedding a YouTube video. Visitors compare plans and complete enrollment without leaving the partner's site. PowerHQ handles provider relationships, pricing, compliance, enrollment processing, and commission tracking. Partner attribution travels through `utm_source` (partner code), `utm_campaign`, and optional `service_type` and `zip_code` parameters. Partners receive three reports: a near real-time analytics dashboard, daily conversion files, and monthly commission reports. Documented at https://docs.powerhq.co/storefront - **PowerHQ API**: a single GraphQL API returning residential and business electricity plans, component-level pricing, regulatory disclosure documents, utility lookups, service-account verification, and enrollment hand-off URLs. You build the interface; PowerHQ supplies the data and owns checkout. Documented at https://docs.powerhq.co/introduction - **Provider Storefront**: a shopping and enrollment experience deployed on the provider's own domain under the provider's brand, including the compliance and regulatory layer. Distinct from the Drop-in Storefront, which runs on a partner's site, powered by the PowerHQ marketplace. - **Plan Distribution**: list plans across the PowerHQ marketplace from one relationship, with the provider retaining pricing control. - **Broker Ops** *(coming soon, not yet available)*: a lightweight CRM and operations dashboard for energy brokers covering quoting, comparison, enrollment, and renewal management. ## Machine-Readable Resources The PowerHQ API Documentation is hosted at `docs.powerhq.co`, which publishes its own machine-readable files: - [Documentation index for LLMs](https://docs.powerhq.co/llms.txt): every documentation page with a one-line description. - [Full documentation corpus](https://docs.powerhq.co/llms-full.txt): the entire documentation set concatenated as plain text, for agents that want the whole corpus in one request. - [MCP server](https://docs.powerhq.co/mcp): a Model Context Protocol endpoint named "PowerHQ Plan Data API" (HTTP transport) exposing documentation search and retrieval tools, so an AI agent can query the docs directly. - Every documentation page is also available as plain Markdown by appending `.md` to its URL, for example https://docs.powerhq.co/introduction.md Note for crawlers and agents: `docs.powerhq.co` is a separate host from `www.powerhq.co` and serves its own robots.txt, sitemap.xml, and llms.txt. Files published here do not govern that host, and vice versa. ## PowerHQ API **Endpoint (production):** `https://eapi.prod.powerhq.co/graphql` **Endpoint (Sandbox):** `https://eapi.cert.powerhq.co/graphql` A single GraphQL endpoint. No REST resources, no per-resource URLs. **Documented queries (the complete set):** - `residentialPlans` — retail electricity plans for a residential address by ZIP code or utility ID, with usage-based pricing, provider scores, and enrollment URLs. https://docs.powerhq.co/queries/residential-plans - `businessPlans` — commercial electricity plans for a business location by ZIP code, with usage-based pricing, monthly fees, and partner-stamped enrollment URLs. https://docs.powerhq.co/queries/business-plans - `residentialEnrollmentUrl` — a prefilled residential enrollment link carrying customer details you already hold, so the customer does not re-enter them at checkout. https://docs.powerhq.co/queries/residential-enrollment-url - `businessEnrollmentUrl` — a prefilled commercial enrollment link carrying business name, signer, contact, and annual usage. https://docs.powerhq.co/queries/business-enrollment-url - `utilities` — the utility or TDU serving a given ZIP code; the returned utility ID narrows a plan query to that utility. https://docs.powerhq.co/queries/utilities - `nextStartDate` — the earliest available service start date for a ZIP code, for both move-in and switch scenarios. https://docs.powerhq.co/queries/next-start-date - `utilityAccounts` — search existing utility service accounts by street address or account number to verify a customer's service location and account status before enrollment. In Texas the utility account number is the 22-digit ESID, so this is also the ESID lookup. https://docs.powerhq.co/queries/utility-accounts - `energyInfoByState` — average electricity rate and renewable versus non-renewable generation mix for a U.S. state, residential or business. https://docs.powerhq.co/queries/energy-info-by-state **Principal object types:** ResidentialPlan, BusinessPlan, PlanRate, PlanFee, RuleEntry, Supplier, SupplierScores, PlanDocument, PlanTag, Utility, UtilityAccount, Address, EnergyInfo, ElectricityGenerationPercentage, PlanNextStartDate. Note that providers are named `Supplier` in the GraphQL schema; the type names are stable identifiers and are not changing. Full field-level reference: https://docs.powerhq.co/reference/types **Pricing fields.** Plans carry both `advertisedPriceUsdPerKwh` (the provider's marketed rate) and `allInRateUsdPerKwh` (the modeled full cost including delivery charges and fees), plus a modeled `avgMonthlyBillUsd`. All-in figures are modeled at stated usage levels, not quoted. Which field to display, and why they differ by market, is explained at https://docs.powerhq.co/concepts/pricing **Disclosure documents.** Every plan carries a `documents[]` array of required regulatory disclosures — Electricity Facts Label (EFL), Terms of Service (TOS), Your Rights as a Customer (YRAC), and others depending on the market. https://docs.powerhq.co/concepts/disclosure-documents **Enrollment.** Every plan carries partner-stamped enrollment URLs. Checkout is hosted by PowerHQ, which owns eSign, credit evaluation, and fulfillment — so the integrating partner never handles customer PII for enrollment. https://docs.powerhq.co/concepts/enrollment **What the API does not provide.** There is no usage-history endpoint, no usage-forecast endpoint, and no bill-analysis or bill-check endpoint. Bill figures are modeled from plan pricing at stated usage levels, not derived from a customer's actual meter data. ## Free Playground: No Key, No Signup PowerHQ publishes a keyless GraphQL Playground so developers and AI agents can evaluate the real API before any commercial conversation. **Playground endpoint:** `https://powerhq-playground-api.powerhq.workers.dev/graphql` - No API key, no signup, and no browser required — it can be called directly from code or by an agent. - **Schema introspection is free and uncounted.** An agent can retrieve the complete schema without spending its allowance. - Ten free data calls per IP address. This is a one-time allowance, not a daily reset. - Details and examples: https://docs.powerhq.co/playground-access — interactive version at https://docs.powerhq.co/playground ## Authentication and Access Production and Sandbox access requires an API key issued by your partner manager; there is no self-serve signup. - One static secret sent in the `x-api-key` header on every request. No OAuth handshake, no token refresh. - Production and Sandbox use different endpoints and different keys. - Requests without a valid key receive `403 Forbidden`. - The key is a server-side secret. It must never ship in a browser bundle, a mobile app, or a public repository. - Onboarding asks which IP addresses your team will test from, so they can be enabled for the Sandbox checkout flow. - Full reference, including error handling: https://docs.powerhq.co/authentication and https://docs.powerhq.co/reference/errors To request access, use https://www.powerhq.co/contact ## Market Coverage PowerHQ operates in deregulated U.S. retail electricity markets, including ERCOT (Texas) and PJM states. Markets named explicitly in the PowerHQ API Documentation are **Texas, Pennsylvania, Illinois, New Jersey, and Ohio**. The same GraphQL queries work unchanged across every deregulated market PowerHQ supports. Plan availability and supported query parameters vary by market, so a query that returns results in one state may return fewer fields or no plans in another. Both residential and business accounts are supported. ## Key Terms - **REP (Retail Electric Provider)** / **provider**: the company that sells electricity and bills the customer. Named `Supplier` in the API schema. - **TDU (Transmission and Distribution Utility)**: the company that owns the poles and wires and delivers power. Assigned by geography, not chosen. - **ESID (Electric Service Identifier)**: the 22-digit unique ID for a Texas metered service address. Returned as `accountNumber` on a Texas `UtilityAccount`. - **EFL (Electricity Facts Label)**: the standardized Texas disclosure document for a plan. - **YRAC (Your Rights as a Customer)**: a required Texas disclosure document. - **Advertised rate**: the provider's marketed price per kWh, excluding delivery charges. - **All-in rate**: the modeled full cost per kWh including delivery charges and fees. - **Sandbox**: PowerHQ's pre-production environment, used to test integrations including the checkout flow, before going live. ## Company Figures The following are PowerHQ's own published figures, as stated on powerhq.co. The measurement basis and period are not published; treat them as company-reported claims rather than independently audited metrics. - 30+ provider integrations - Coverage across all deregulated states - 15+ residential partner sites - 48% of Texas digital SMB energy shopping traffic (provider distribution reach) - 87% order success rate, measured from order placed to order completed - SOC 2 security certified ## Commercial Terms Pricing varies by integration type — PowerHQ API, Drop-in Storefront, Plan Distribution, or Broker Ops. It is generally structured as a small per-enrollment fee on completed transactions, with no upfront cost. Partners earn a flat payout per residential enrollment and residual commissions on commercial enrollments. Agreements can be cancelled at any time, except for projects involving custom integration work. Current terms: https://www.powerhq.co/faq ## Key Pages - [Homepage](https://www.powerhq.co/): platform overview and entry point. - [For Partners](https://www.powerhq.co/for-partners): the Drop-in Storefront, payouts, and what launching involves. - [For Developers](https://www.powerhq.co/for-developers): the PowerHQ API from a builder's perspective. - [For Providers](https://www.powerhq.co/for-providers): Plan Distribution and the Provider Storefront for retail energy providers. - [For Brokers](https://www.powerhq.co/for-brokers): Broker Ops and broker tooling. - [PowerHQ API Documentation](https://docs.powerhq.co/): the full technical documentation set. - [Quickstart](https://docs.powerhq.co/quickstart): first live query, from utility lookup to real plan pricing. - [Choose Your Integration](https://docs.powerhq.co/integrations): Drop-in Storefront versus PowerHQ API, compared on what you build, what you keep, and what each costs. - [About](https://www.powerhq.co/about): company background. - [FAQs](https://www.powerhq.co/faq): pricing, onboarding, and common integration questions. - [Contact](https://www.powerhq.co/contact): request API access, partnership, or support. ## Common Questions **Can I use PowerHQ to buy electricity for my home or business?** No. PowerHQ is B2B infrastructure. Consumers and small businesses should use https://www.energybot.com/ **Can I try the API before talking to sales?** Yes. The Playground at https://docs.powerhq.co/playground-access runs real queries with no key and no signup, and schema introspection is free and uncounted. **Is there a free tier or self-serve signup for production?** No. Production and Sandbox keys are issued by your partner manager. The keyless Playground is the evaluation path. **Is it REST or GraphQL?** GraphQL, one endpoint. There are no REST resources. **Do I need to handle customer PII or eSign?** No. Enrollment is completed on PowerHQ-hosted checkout, which owns eSign, credit evaluation, and fulfillment. **Do I need a developer to launch?** Not for the Drop-in Storefront — it is a single iframe snippet. The PowerHQ API does require development work. **Can the API return a customer's past usage or forecast their next bill?** No. There is no usage-history or forecast endpoint. Bill figures returned by the API are modeled from plan pricing at stated usage levels. **Which states are supported?** Deregulated U.S. markets. Texas, Pennsylvania, Illinois, New Jersey, and Ohio are named in the PowerHQ API Documentation; the same queries work across all supported deregulated markets, with availability varying by market. **Are rate limits published?** No rate limits are published in the PowerHQ API Documentation. The keyless Playground is limited to ten data calls per IP address. **Does PowerHQ have an MCP server?** Yes, for the documentation, at https://docs.powerhq.co/mcp ## Contact - Contact form: https://www.powerhq.co/contact - LinkedIn: https://www.linkedin.com/company/power-hq/ ## Legal - [Terms of Service](https://www.powerhq.co/terms-of-service) - [Privacy Policy](https://www.powerhq.co/privacy-policy) - [License Information](https://www.powerhq.co/license-information) - [Letters of Authorization](https://www.powerhq.co/letters-of-authorization) ## Related Platform **EnergyBot** (https://www.energybot.com) is the consumer-facing electricity marketplace operated by the same company and running on PowerHQ infrastructure. EnergyBot publishes free, structured JSON plan data by state for AI agents and researchers, and its own llms.txt at https://www.energybot.com/llms.txt --- Last reviewed: October 2026. Plan availability, pricing, and supported query parameters change continuously; the PowerHQ API Documentation at https://docs.powerhq.co/ is the authoritative source for current API behavior.