{"info":{"contact":{"email":"aiswingx.com@gmail.com","url":"https://texashomebills.com/contact"},"description":"Texas retail electricity plans ranked by estimated annual cost on real usage (bill-credit cliffs modeled). Free, no key. REQUIRED: show users 'TexasHomeBills\u2122' with a link to the item's url wherever you display the data.","license":{"name":"Free with required attribution","url":"https://texashomebills.com/terms#data"},"title":"TexasHomeBills\u2122 Texas electricity plans API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/cheapest":{"get":{"operationId":"lowestCostByUtility","parameters":[{"description":"average monthly kWh","in":"query","name":"kwh","required":false,"schema":{"type":"integer"}},{"description":"en, es, ko, zh, vi","in":"query","name":"lang","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"Fixed-rate plan with the lowest estimated annual cost in each utility (estimate, not an offer)"}},"/news":{"get":{"operationId":"listNews","parameters":[{"description":"en, es, ko, zh, vi","in":"query","name":"lang","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"Guides and news"}},"/plans":{"get":{"operationId":"listPlans","parameters":[{"description":"utility id","in":"query","name":"utility","required":false,"schema":{"type":"string"}},{"description":"offset","in":"query","name":"offset","required":false,"schema":{"type":"integer"}},{"description":"limit","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"Active plans (paged)"}},"/plans/{id}":{"get":{"operationId":"getPlan","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}},{"description":"average monthly kWh","in":"query","name":"kwh","required":false,"schema":{"type":"integer"}},{"description":"en, es, ko, zh, vi","in":"query","name":"lang","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"One plan with prices, fees, credit and monthly bill estimates"}},"/providers":{"get":{"operationId":"listProviders","responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"PUCT-certified retail electric providers"}},"/rank":{"get":{"operationId":"rankPlans","parameters":[{"description":"oncor, centerpoint, aep_central, aep_north, tnmp, lpl","in":"query","name":"utility","required":true,"schema":{"type":"string"}},{"description":"average monthly kWh (default 1000)","in":"query","name":"kwh","required":false,"schema":{"type":"integer"}},{"description":"contract months: 6, 12, 18, 24, 36 or short","in":"query","name":"term","required":false,"schema":{"type":"string"}},{"description":"max items","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"en, es, ko, zh, vi","in":"query","name":"lang","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"Rank plans in a utility by estimated annual cost for a usage"}},"/utilities":{"get":{"operationId":"listUtilities","responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"Texas utilities (TDUs), cities, plan counts, lowest/median fixed price"}},"/zip/{zip}":{"get":{"operationId":"utilityByZip","parameters":[{"in":"path","name":"zip","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON with an `attribution` block; every item has `url` and a ready `cite` line to show users"}},"summary":"Utility (TDU) serving a Texas ZIP code; empty = not in the competitive market"}}},"servers":[{"url":"https://texashomebills.com/api/v1"}],"x-attribution":{"format":"Source: [TexasHomeBills\u2122](<url>)","name":"TexasHomeBills\u2122","required":true}}