Calculation

Calculate a verified base-tariff estimate

Runs the state-specific tariff calculation contract for supported public states BR, MH, GJ and TN subject to each state release and payable gate. Use canonical licensee/category identifiers returned by discovery. Unsupported or ambiguous routing fails closed; the API never guesses a tariff, licensee or payable adjustment. Jharkhand V1 uses VERIFIED_TARIFF_ESTIMATION_V1 with location-aware fail-closed routing. JBVNL, TSL, TSUISL and DVC_JH have verified estimation paths; SAIL_BSL remains held-unverified and TPCL is excluded from consumer retail routing. Unresolved FPPAS and electricity duty remain null/held; complete_payable and production_payable remain false.

post/calculate

Request

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

Request body

state_code'BR' | 'MH' | 'GJ' | 'TN' | 'RJ' | 'OD' | 'TS' | 'JH'

Canonical state code for the public calculation route. Use GET /states and GET /capabilities for current release, verification and payable status.

subcategory_codestring

Exact code returned by GET /categories.

tod_periodstring
rts_voltage_mode'standard' | 'above_132kv' | 'below_132kv'
apply_htss_11kv_surchargeboolean
effective_onstring date

Must be on or after 2026-04-01.

billing_daysinteger

Optional for Bihar domestic categories. Only 25, 30, or 40 are currently accepted for subsidy-entitlement evaluation; every other value fails closed.

licensee_code'MH_MSEDCL' | 'MH_TPCD' | 'MH_AEML' | 'MH_BEST'

Required for Maharashtra. Canonical values: MH_MSEDCL, MH_TPCD, MH_AEML, MH_BEST.

financial_yearstring
category_idstring

Canonical Maharashtra category identifier returned by GET /categories.

billing_datestring date
metering_mode'gross_metering'

Odisha-only discriminator. Use gross_metering only when state_code=OD. Omit for the existing Odisha domestic path and for unrelated states.

generation_kwhnumber

Odisha gross-metering generation quantity. Required when state_code=OD and metering_mode=gross_metering. Supplying this field alone does not activate gross metering.

districtstring

Jharkhand location-routing signal. Use canonical district name.

district_namestring

Jharkhand district-name alias accepted by the JH V1 resolver.

citystring

Jharkhand city/location routing signal.

areastring

Jharkhand service-area routing signal.

boundary_verifiedboolean

Explicit boundary verification signal for ambiguous Jharkhand service areas.

service_contextstring

Optional verified service/licensee context used by Jharkhand fail-closed routing.

supply_typestring

State-specific supply type. Jharkhand examples use LT or HT.

usestring

Jharkhand consumer-use signal such as DOMESTIC.

area_classstring

Jharkhand tariff area classification where required, for example RURAL or URBAN.

consumptionnumber

Jharkhand metered consumption used by VERIFIED_TARIFF_ESTIMATION_V1.

consumption_unitstring

Unit for Jharkhand consumption, for example kWh.

voltage_kvnumber

Optional Jharkhand voltage signal for applicable HT/DVC routing.

contract_demand_kwnumber

Optional contracted demand in kW.

recorded_demand_kwnumber

Optional recorded demand in kW.

contract_demand_kvanumber

Optional contracted demand in kVA.

recorded_demand_kvanumber

Optional recorded demand in kVA.

Example request

{
  "billing_days": 30,
  "financial_year": "2026-27"
}

Response

Verified calculation response. Bihar responses include final_payable, electricity_duty and ancillary_charges fail-closed contracts.

status'ok' required
api_version'PEI Verified Tariff API V1.2.0' required
request_idstring required

Example response

{
  "data": {
    "electricity_duty": {
      "status": "verified_applied_statutory_duty",
      "statutory_source_contract": {
        "notification": {
          "identifier": "S.O. No. 182",
          "date": "2018-05-25",
          "official_registry": "India Code"
        }
      }
    },
    "ancillary_charges": {
      "status": "verified_fail_closed_contract_complete",
      "meter_rent": {
        "status": "not_verified_separate_consumer_charge"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.