Home EV charging cost on the cheapest fixed-rate plans in a utility: each plan's estimated 12-month cost with and without the EV, per month and per mile. The response also has a time_of_use section: free-nights and free-weekends plans priced on overnight charging, with each plan's exact free hours as written in its EFL, or the reason it was excluded. No gasoline comparison.

get/electricity/ev-charging-cost

Request

  • Base URL: https://texashomebills.com/api/v1
  • URL: https://texashomebills.com/api/v1/electricity/ev-charging-cost
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

utilitystring required

oncor, centerpoint, aep_central, aep_north, tnmp, lpl

kwhinteger

home average monthly kWh (default 1000)

ev_milesnumber

optional EV: miles driven per month (adds ev_miles × kWh/mile ÷ charging_efficiency to every month)

vehiclestring

optional EV model id (EPA combined efficiency, fueleconomy.gov): tesla-model-y-long-range-awd, tesla-model-3-long-range-rwd, tesla-cybertruck-awd, ford-f-150-lightning-4wd-sr, ford-mustang-mach-e-awd, chevrolet-equinox-ev-fwd, chevrolet-blazer-ev-rwd, hyundai-ioniq-5-rwd, kia-ev6-long-range-rwd, kia-ev9-long-range-awd, rivian-r1s-dual-large, nissan-leaf, honda-prologue-fwd, volkswagen-id4-pro, bmw-i4-edrive40

ev_kwh_per_milenumber

optional instead of vehicle (default 0.3)

charging_efficiencynumber

default 0.9 with ev_kwh_per_mile; 1.0 with vehicle (EPA figures include charging losses)

ev_night_sharenumber

time_of_use section: share of EV kWh charged overnight (10 pm - 6 am), 0-1 or percent (default 0.80)

home_night_sharenumber

time_of_use section: share of the home's kWh in a free-nights plan's free hours, 0-1 (default: the share the plan's own label assumes, 35%)

Response

JSON with an attribution block; every item has url and a ready cite line to show users

Changes

No recorded changes to this operation across all 1 revision of this API.