---
title: "Legacy path, still supported: same as GET /electricity/history/plans. Pro: every listing recorded on one day (daily history since 2026-10-09)"
method: GET
path: "/history/plans"
---

# Legacy path, still supported: same as GET /electricity/history/plans. Pro: every listing recorded on one day (daily history since 2026-10-09)

`GET /history/plans`

## Request

- Base URL: `https://texashomebills.com/api/v1`
- URL: `https://texashomebills.com/api/v1/history/plans`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Query parameters

- `date` string
- `utility` string
- `limit` integer
- `offset` integer

## Response `200`

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

## Other responses

- `401`: invalid_api_key: the key is unknown or revoked (JSON with attribution and get_key)
- `403`: pro_required: endpoint needs a key from an active Pro subscription
- `429`: rate_limited: JSON with limit, window, reset (Unix time), reset_at, retry_after, get_key; Retry-After header

---

[API](https://skmtc.dev/texashomebills/apis/texashomebills-texas-electricity-plans-and-market-data-api.md) · [All operations](https://skmtc.dev/texashomebills/apis/texashomebills-texas-electricity-plans-and-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/texashomebills/apis/texashomebills-texas-electricity-plans-and-market-data-api/revisions/5f2562edbc2e?raw)