---
title: "List public API states and release status"
method: GET
path: "/states"
tags: ["Catalogue"]
---

# List public API states and release status

`GET /states`

## Request

- Base URL: `https://powerexpertindia.com/v1`
- URL: `https://powerexpertindia.com/v1/states`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns the current public state inventory for Bihar, Maharashtra, Gujarat and Tamil Nadu, including each state release/payable status and the identifiers required for state-specific routing.

## Response `200`

Released state list.

- StatesEnvelope
  - `status` 'ok', required
  - `api_version` 'PEI Verified Tariff API V1.2.0', required
  - `request_id` string, required
  - `data` StateSummary[], required
    - `state_code` 'BR', required
    - `state_name` 'Bihar', required
    - `financial_year` '2026-27', required
    - `effective_from` string, date, required
    - `verification_tier` 'verified_strict', required
    - `release_status` 'released', required
    - `supported_subcategories` 32, required
    - `schedule_rows` 34, required
  - `meta` object, required
    - `count` 1, required

## Other responses

- `401`: Authentication failed.
- `403`: The key, state, scope, or browser origin is not allowed.
- `405`: Allowed method: GET.
- `429`: The configured per-minute or burst allowance was reached.
- `500`: Unexpected server error.
- `503`: The verified release, key registry, or runtime evidence is unavailable.

---

[API](https://skmtc.dev/powerexpertindia/apis/power-expert-india-verified-tariff-api.md) · [All operations](https://skmtc.dev/powerexpertindia/apis/power-expert-india-verified-tariff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/powerexpertindia/apis/power-expert-india-verified-tariff-api/revisions/9a6f076ae01e?raw)