---
title: "List verified categories"
method: GET
path: "/categories"
tags: ["Catalogue"]
---

# List verified categories

`GET /categories`

## Request

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

Lists verified or exposed tariff categories for the requested state. Supported public state codes: BR, MH, GJ and TN. Maharashtra and Gujarat use explicit licensee-specific routing where applicable; use canonical identifiers returned by discovery and never assume a default licensee.

## Query parameters

- `state_code` 'BR' | 'MH' | 'GJ' | 'TN'
- `effective_on` string, date
- `licensee_code` 'MH_MSEDCL' | 'MH_TPCD' | 'MH_AEML' | 'MH_BEST'
- `financial_year` string

## Response `200`

Verified category catalogue.

- CategoriesEnvelope
  - `status` 'ok', required
  - `api_version` 'PEI Verified Tariff API V1.2.0', required
  - `request_id` string, required
  - `data` CategorySummary[], required
    - `state_code` 'BR', required
    - `financial_year` string, required
    - `effective_from` string, date, required
    - `state_subcategory_code` string, required
    - `raw_category_label` string, required
    - `canonical_category_code` string, nullable
    - `layer` 'domestic' | 'lt' | 'ht', required
    - `supply_type` string, required
    - `slab_type` 'flat' | 'telescopic' | 'non_telescopic', required
    - `schedule_row_count` integer, required
    - `required_calculation_inputs` string[], required
    - `optional_calculation_inputs` string[], required
    - `verification_tier` 'verified_strict', required
  - `meta` object, required
    - `state_code` 'BR', required
    - `count` integer, required
    - `effective_on` string, date, required

## Other responses

- `400`: Query parameter is too long.
- `401`: Authentication failed.
- `403`: The key, state, scope, or browser origin is not allowed.
- `404`: The requested state or state-specific contract is not available for this endpoint or serving release.
- `405`: Allowed method: GET.
- `422`: effective_on must use YYYY-MM-DD.
- `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)