nextStartDate query returns the earliest date a customer can begin electricity service for a given ZIP code. Call this query before submitting a businessPlans query that accepts a startDate argument — it tells you the minimum valid date so you can avoid validation errors caused by requesting a start date that is too soon.
Parameters
String
required
The five-digit ZIP code for which to check the earliest available start date.
Boolean
Set to
true when the customer is establishing new service at a location (move-in). Set to false, or omit the argument, when the customer is switching providers at an address that already has active service. Move-in and switch scenarios typically resolve to different earliest start dates.Example
Response fields
Date
The earliest available service start date, returned in
YYYY-MM-DD format (for example, "2026-07-21").[BusinessPlan]
Optionally include business plans that are available starting from this date by adding a
businessPlans selection to your query.If you pass a
startDate to businessPlans that falls before the resolved minimum returned by nextStartDate, the API returns a validation error. Always call nextStartDate first and use the returned date as the floor value for any startDate argument you provide downstream.