businessPlans: Fetch Commercial Electricity Plans by ZIP

The businessPlans query returns available retail electricity plans for a U.S. commercial service location identified by ZIP code. Provide your customer’s annual usage to receive accurate usage-based pricing, indicate whether the request is for new service or a switch, and optionally pass a desired start date. Each plan in the response includes the supplier, contract term, per-kWh price, monthly fee, renewable percentage, and ready-to-use enrollment URLs stamped with your partner code.

Parameters

String

required

ZIP code for the business service location. This is the only required parameter — the query will not execute without it.

Float

Annual electricity usage in kWh for the business. Supplying this value ensures that the returned price reflects the supplier’s rate at the customer’s actual usage level. Omit only when usage is unknown.

Boolean

Set to true when the customer is establishing new service at a location (move-in). Defaults to false, which represents a switch from an existing retail electricity provider. Passing the correct value ensures the returned enrollment URLs route the customer through the right onboarding flow.

Date

Requested service start date in YYYY-MM-DD format. The date must be on or after the minimum allowable start date for the service territory — passing an earlier date returns a validation error.

Use the nextStartDate query to retrieve the minimum allowable start date for a given ZIP code before calling businessPlans with a specific startDate.

Example

{
  businessPlans(zipCode: "75070", annualUsageInkWh: 23000, isMoveIn: true) {
    id
    term
    price
    monthlyFee
    supplier { name }
    enrollmentUrl
    agreementUrl
  }
}

{
  "data": {
    "businessPlans": [
      {
        "id": "58b2e47e-91d7-4b72-9b5d-9bc9136613d8",
        "term": 3,
        "price": 0.0705,
        "monthlyFee": 4.95,
        "supplier": { "name": "NRG Energy, Inc." },
        "enrollmentUrl": "https://www.cert.powerhq.co/app.html?utm_source=YOUR_PARTNER_CODE&utm_medium=referral&utm_campaign=partners#/redirect?ftype=BUSINESS_PARTNER&plan_id=58b2e47e-91d7-4b72-9b5d-9bc9136613d8&zip_code=75070&start_date=2026-07-23&annual_usage=23000.0&is_move_in=true&ref=YOUR_PARTNER_CODE",
        "agreementUrl": "https://www.cert.powerhq.co/api/document/sample/template/v3/AgreementPreview.pdf?key=TX/NRG/ONCOR&type=supplier_contract"
      }
    ]
  }
}

Response fields

Unique identifier for the business plan.

Int

Contract length in months.

Float

Effective energy price in $/kWh, calculated based on the provided annualUsageInkWh. Omitting annualUsageInkWh may result in a default usage assumption that does not reflect your customer’s actual costs.

Float

Fixed monthly fee in USD charged in addition to the per-kWh energy charge.

Int

Percentage of energy sourced from renewable generation, from 0 to 100.

Supplier

The retail electricity supplier offering this plan.

Show supplier fields

Unique identifier for the supplier.

String

Full legal name of the supplier.

String

Abbreviated or display name of the supplier, suitable for UI labels. May be null.

String

URL of the supplier’s logo image.

String

Regulatory registration or license ID for the supplier. May be null when not available.

String

Hosted enrollment hand-off URL, pre-stamped with your partner code. Send the customer to this URL to complete sign-up through the standard PowerHQ-hosted enrollment flow.

String

Embeddable enrollment hand-off URL, pre-stamped with your partner code. Use this URL inside an iframe or webview to embed the enrollment experience directly within your product.

String

Direct URL to the supplier’s contract PDF for this plan. Display or download this document so the customer can review the full terms of service before enrolling.

For guidance on when to use enrollmentUrl versus headlessEnrollmentUrl and how partner stamping works, see Enrollment Concepts.

Integrate with PowerHQ

Plan Data API

Core Concepts

Queries

Playground

Reference

businessPlans: Fetch Commercial Electricity Plans by ZIP

Parameters

Example

Response fields

​Parameters

​Example

​Response fields

Parameters

Example

Response fields