---
title: "Legacy path, still supported: same as GET /electricity/rank. Rank plans in a utility by estimated annual cost for a usage"
method: GET
path: "/rank"
---

# Legacy path, still supported: same as GET /electricity/rank. Rank plans in a utility by estimated annual cost for a usage

`GET /rank`

## Request

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

## Query parameters

- `utility` string, required
- `kwh` integer
- `term` string
- `limit` integer
- `lang` string
- `ev_miles` number
- `vehicle` string
- `ev_kwh_per_mile` number
- `charging_efficiency` number

## 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)
- `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)