> For the complete documentation index, see [llms.txt](https://india-energy-stack.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://india-energy-stack.gitbook.io/docs/schemas/electricitycredential.md).

# ElectricityCredential

*A W3C Verifiable Credential, issued per meter or connection by a distribution licensee, that carries the static facts of a consumer's connection and the energy resources behind the meter.*

|                    |                                                                                                                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Canonical base** | `https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential`                                                                                                                         |
| **Latest version** | **v1.2**                                                                                                                                                                                                     |
| **Status**         | Stable — In Pilot (current: **v1.2**) · **Issued by** DISCOMs · **Consumed by** consumers (holder-bound), grid operators and aggregators (bearer), banks / subsidy portals / DER marketplaces (as verifiers) |
| **Category**       | Verifiable Credentials                                                                                                                                                                                       |
| **Used in**        | [Consumer Energy Passport](/docs/use-case-implementation-guides/consumer-energy-passport.md) · [DER Visibility](/docs/use-case-implementation-guides/der-visibility.md)                                      |

What this schema is for, in plain language — standards basis, design rationale, open points: [ElectricityCredential (Schemas Overview)](/docs/schemas-overview/schemas-overview/electricity-credential.md).

## Developer resources — v1.2 (current)

| Resource                 | URL                                                                                                                                                                                                                                  | Notes                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| Field reference (README) | <https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/README.md>                                                                                                                                  | human-readable field reference for this version              |
| `attributes.yaml`        | <https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/attributes.yaml>                                                                                                                            | OpenAPI 3.1 source of truth                                  |
| `schema.json`            | <https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/schema.json>                                                                                                                                | compiled JSON Schema (Draft 2020-12) — validate against this |
| `context.jsonld`         | <https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/context.jsonld>                                                                                                                             | JSON-LD context for semantic resolution                      |
| `vocab.jsonld`           | <https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/vocab.jsonld>                                                                                                                               | RDF vocabulary with standards alignments                     |
| `examples/`              | [https://github.com/India-Energy-Stack/ies-accelerator/tree/main/schemas/ElectricityCredential/v1.2/examples](https://github.com/India-Energy-Stack/ies-accelerator/tree/main/schemas/ElectricityCredential/v1.2/examples/README.md) | worked payloads                                              |

## Field reference — v1.2 (current)

*A field name in **bold** with a trailing **\*** is required; all others are optional. **Type** shows units for QuantitativeValue models. Descriptions are simplified to the plain meaning of each field — the per-version pages (see **Versions** below) carry the full text, standards basis and notes.*

**ElectricityCredential v1.2**

| Field                      | Type         | Description |
| -------------------------- | ------------ | ----------- |
| **`id`** \*                | uri          | —           |
| **`type`** \*              | list of text | —           |
| **`issuer`** \*            | object       | —           |
| **`validFrom`** \*         | date-time    | —           |
| `validUntil`               | date-time    | —           |
| `credentialStatus`         | object       | —           |
| **`credentialSubject`** \* | object       | —           |
| `proof`                    | object       | —           |

**CustomerDetails**

| Field                          | Type      | Description                                                                                                                                                                |
| ------------------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`fullName`** \*              | text      | Full name of the customer as per ID proof.                                                                                                                                 |
| `careOf`                       | object    | Care-of (c/o) reference person used to uniquely identify / disambiguate a customer who may share the same fullName with others in a locality (e.g. a village).             |
| **`installationAddress`** \*   | Location  | Physical location of the metered installation. geo (GeoJSON Point, coordinates \[longitude, latitude]) is required; address (schema.org PostalAddress fields) is optional. |
| **`serviceConnectionDate`** \* | date-time | Date and time the service connection was activated, with timezone offset (ISO 8601).                                                                                       |

**Location**

| Field        | Type            | Description |
| ------------ | --------------- | ----------- |
| **`geo`** \* | GeoJSONGeometry | —           |
| `address`    | Address         | —           |

**GeoJSONGeometry**

| Field         | Type                                                                                                          | Description                                                           |
| ------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| `bbox`        | list of number                                                                                                | Optional bounding box `[west, south, east, north]` in degrees.        |
| `coordinates` | list of —                                                                                                     | Coordinates per RFC 7946 for all types **except** GeometryCollection. |
| `geometries`  | list of GeoJSONGeometry                                                                                       | Member geometries when `type` is **GeometryCollection**.              |
| **`type`** \* | `Point` / `LineString` / `Polygon` / `MultiPoint` / `MultiLineString` / `MultiPolygon` / `GeometryCollection` | —                                                                     |

**Address**

| Field             | Type | Description                                       |
| ----------------- | ---- | ------------------------------------------------- |
| `addressCountry`  | text | Country name or ISO-3166-1 alpha-2 code.          |
| `addressLocality` | text | City/locality.                                    |
| `addressRegion`   | text | State/region/province.                            |
| `extendedAddress` | text | Address extension (apt/suite/floor, C/O).         |
| `postalCode`      | text | Postal/ZIP code.                                  |
| `streetAddress`   | text | Street address (building name/number and street). |

**CustomerProfile**

| Field                    | Type                       | Description                                           |
| ------------------------ | -------------------------- | ----------------------------------------------------- |
| **`customerNumber`** \*  | text                       | Utility customer account (CA) number.                 |
| `idRef`                  | IdRef                      | —                                                     |
| **`energyResources`** \* | list of EnergyResource     | All physical energy assets for this account.          |
| `consumptionProfiles`    | list of ConsumptionProfile | Tariff and load characteristics per meter connection. |

**IdRef**

| Field              | Type | Description                                             |
| ------------------ | ---- | ------------------------------------------------------- |
| **`issuedBy`** \*  | uri  | DID or URI of the issuing authority.                    |
| **`subjectId`** \* | text | Subject identifier in authority-domain:id-value format. |

**EnergyResourceMeter**

| Field             | Type                           | Description                                |
| ----------------- | ------------------------------ | ------------------------------------------ |
| **`id`** \*       | text                           | Stable identifier for this resource.       |
| **`type`** \*     | text                           | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource | Topology — child resources.                |
| `parentResources` | list of text                   | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceMeterAttributes  | —                                          |

**EnergyResourceCommon**

| Field             | Type                           | Description                                |
| ----------------- | ------------------------------ | ------------------------------------------ |
| `id`              | text                           | Stable identifier for this resource.       |
| `type`            | text                           | Asset class discriminator.                 |
| `subResources`    | list of text or EnergyResource | Topology — child resources.                |
| `parentResources` | list of text                   | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceCommonAttributes | Attribute bag.                             |

**EnergyResourceCommonAttributes**

| Field               | Type                        | Description                                                              |
| ------------------- | --------------------------- | ------------------------------------------------------------------------ |
| `make`              | text                        | Manufacturer (free text).                                                |
| `model`             | text                        | Model (free text).                                                       |
| `ratedPower`        | QVPower (`W` / `kW` / `MW`) | Manufacturer-rated peak power (nameplate value in principal direction).  |
| `maxExport`         | QVPower (`W` / `kW` / `MW`) | Maximum power this resource injects to the grid (generates/discharges).  |
| `maxImport`         | QVPower (`W` / `kW` / `MW`) | Maximum power this resource draws from the grid (absorbs/charges).       |
| `telemetryProvider` | text                        | Vendor API / data source identifier for telemetry.                       |
| `commissioningDate` | date-time                   | ISO 8601 date-time the asset was commissioned.                           |
| `location`          | Location                    | Physical location of this asset.                                         |
| `serialNumber`      | text                        | Manufacturer-assigned device serial number from the equipment nameplate. |
| `inspection`        | object                      | Commissioning / safety inspection record for the asset.                  |
| `aggregator`        | object                      | Third-party flexibility / demand-response enrolment for this asset.      |

**QVPower**

| Field          | Type              | Description |
| -------------- | ----------------- | ----------- |
| **`value`** \* | number            | —           |
| **`unit`** \*  | `W` / `kW` / `MW` | —           |

**EnergyResourceMeterAttributes**

| Field                     | Type                                                                                                              | Description                                                              |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `make`                    | text                                                                                                              | Manufacturer (free text).                                                |
| `model`                   | text                                                                                                              | Model (free text).                                                       |
| `ratedPower`              | QVPower (`W` / `kW` / `MW`)                                                                                       | Manufacturer-rated peak power (nameplate value in principal direction).  |
| `maxExport`               | QVPower (`W` / `kW` / `MW`)                                                                                       | Maximum power this resource injects to the grid (generates/discharges).  |
| `maxImport`               | QVPower (`W` / `kW` / `MW`)                                                                                       | Maximum power this resource draws from the grid (absorbs/charges).       |
| `telemetryProvider`       | text                                                                                                              | Vendor API / data source identifier for telemetry.                       |
| `commissioningDate`       | date-time                                                                                                         | ISO 8601 date-time the asset was commissioned.                           |
| `location`                | Location                                                                                                          | Physical location of this asset.                                         |
| `serialNumber`            | text                                                                                                              | Manufacturer-assigned device serial number from the equipment nameplate. |
| `inspection`              | object                                                                                                            | Commissioning / safety inspection record for the asset.                  |
| `aggregator`              | object                                                                                                            | Third-party flexibility / demand-response enrolment for this asset.      |
| `meterCapability`         | `Electromechanical` / `CMRI` / `AMR` / `AMI`                                                                      | Communication/automation generation.                                     |
| `energyDirection`         | `Forward` / `Reverse` / `Bidirectional` / `Net`                                                                   | Energy flow direction metered at this point.                             |
| `functions`               | list of `ToU` / `NetMetering` / `MaxDemand` / `LoadControl` / `TamperDetection` / `PowerQuality` / `EventLogging` | Active meter capabilities.                                               |
| `feeder`                  | text                                                                                                              | Feeder identifier this meter is supplied from.                           |
| `bus`                     | text                                                                                                              | Busbar identifier at the meter's connection point.                       |
| `communicationTechnology` | `PLC` / `RF_Mesh` / `GPRS` / `NB-IoT` / `LoRa` / `ZigBee` / `Other`                                               | Last-mile physical-layer communication technology.                       |
| `applicationProtocol`     | `DLMS_COSEM` / `ANSI_C12_18` / `IEC_61850` / `Modbus` / `Other`                                                   | Application-layer protocol for meter data.                               |

**EnergyResourceGenerator**

| Field             | Type                                                                     | Description                                |
| ----------------- | ------------------------------------------------------------------------ | ------------------------------------------ |
| **`id`** \*       | text                                                                     | Stable identifier for this resource.       |
| **`type`** \*     | `SOLAR_PV` / `SOLAR` / `WIND` / `HYDRO` / `BIOGAS` / `CHP` / `FUEL_CELL` | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource                                           | Topology — child resources.                |
| `parentResources` | list of text                                                             | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceGeneratorAttributes                                        | —                                          |

**EnergyResourceGeneratorAttributes**

| Field               | Type                        | Description                                                                                            |
| ------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------ |
| `make`              | text                        | Manufacturer (free text).                                                                              |
| `model`             | text                        | Model (free text).                                                                                     |
| `ratedPower`        | QVPower (`W` / `kW` / `MW`) | Manufacturer-rated peak power (nameplate value in principal direction).                                |
| `maxExport`         | QVPower (`W` / `kW` / `MW`) | Maximum power this resource injects to the grid (generates/discharges).                                |
| `maxImport`         | QVPower (`W` / `kW` / `MW`) | Maximum power this resource draws from the grid (absorbs/charges).                                     |
| `telemetryProvider` | text                        | Vendor API / data source identifier for telemetry.                                                     |
| `commissioningDate` | date-time                   | ISO 8601 date-time the asset was commissioned.                                                         |
| `location`          | Location                    | Physical location of this asset.                                                                       |
| `serialNumber`      | text                        | Manufacturer-assigned device serial number from the equipment nameplate.                               |
| `inspection`        | object                      | Commissioning / safety inspection record for the asset.                                                |
| `aggregator`        | object                      | Third-party flexibility / demand-response enrolment for this asset.                                    |
| `nominalPower`      | QVPower (`W` / `kW` / `MW`) | Nominal (nameplate) power output.                                                                      |
| `efficiency`        | number                      | Conversion efficiency as a percentage (0–100).                                                         |
| `dcArrayCapacity`   | QVPower (`W` / `kW` / `MW`) | DC-side nameplate capacity of a photovoltaic array at Standard Test Conditions (industry term: "kWp"). |

**EnergyResourceStorage**

| Field             | Type                            | Description                                |
| ----------------- | ------------------------------- | ------------------------------------------ |
| **`id`** \*       | text                            | Stable identifier for this resource.       |
| **`type`** \*     | `BESS` / `BATTERY`              | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource  | Topology — child resources.                |
| `parentResources` | list of text                    | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceStorageAttributes | —                                          |

**EnergyResourceStorageAttributes**

| Field                    | Type                                                                              | Description                                                                                                                                                        |
| ------------------------ | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `make`                   | text                                                                              | Manufacturer (free text).                                                                                                                                          |
| `model`                  | text                                                                              | Model (free text).                                                                                                                                                 |
| `ratedPower`             | QVPower (`W` / `kW` / `MW`)                                                       | Manufacturer-rated peak power (nameplate value in principal direction).                                                                                            |
| `maxExport`              | QVPower (`W` / `kW` / `MW`)                                                       | Maximum power this resource injects to the grid (generates/discharges).                                                                                            |
| `maxImport`              | QVPower (`W` / `kW` / `MW`)                                                       | Maximum power this resource draws from the grid (absorbs/charges).                                                                                                 |
| `telemetryProvider`      | text                                                                              | Vendor API / data source identifier for telemetry.                                                                                                                 |
| `commissioningDate`      | date-time                                                                         | ISO 8601 date-time the asset was commissioned.                                                                                                                     |
| `location`               | Location                                                                          | Physical location of this asset.                                                                                                                                   |
| `serialNumber`           | text                                                                              | Manufacturer-assigned device serial number from the equipment nameplate.                                                                                           |
| `inspection`             | object                                                                            | Commissioning / safety inspection record for the asset.                                                                                                            |
| `aggregator`             | object                                                                            | Third-party flexibility / demand-response enrolment for this asset.                                                                                                |
| `storageCapacity`        | QVEnergy (`kWh` / `MWh`)                                                          | Rated stored-energy capacity.                                                                                                                                      |
| `storageType`            | `LithiumIon` / `LeadAcid` / `FlowBattery` / `NaS` / `NiCd` / `Flywheel` / `Other` | Battery storage technology type.                                                                                                                                   |
| `stateOfHealthPct`       | number                                                                            | Battery state-of-health as a percentage (0–100).                                                                                                                   |
| `roundTripEfficiencyPct` | number                                                                            | AC-to-AC round-trip efficiency as a percentage (0–100): the fraction of energy returned to the grid relative to energy drawn during a full charge/discharge cycle. |

**QVEnergy**

| Field          | Type          | Description |
| -------------- | ------------- | ----------- |
| **`value`** \* | number        | —           |
| **`unit`** \*  | `kWh` / `MWh` | —           |

**EnergyResourceEVCharger**

| Field             | Type                              | Description                                |
| ----------------- | --------------------------------- | ------------------------------------------ |
| **`id`** \*       | text                              | Stable identifier for this resource.       |
| **`type`** \*     | `EV_CHARGER` / `EV_V2G`           | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource    | Topology — child resources.                |
| `parentResources` | list of text                      | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceEVChargerAttributes | —                                          |

**EnergyResourceEVChargerAttributes**

| Field               | Type                                                                                | Description                                                              |
| ------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `make`              | text                                                                                | Manufacturer (free text).                                                |
| `model`             | text                                                                                | Model (free text).                                                       |
| `ratedPower`        | QVPower (`W` / `kW` / `MW`)                                                         | Manufacturer-rated peak power (nameplate value in principal direction).  |
| `maxExport`         | QVPower (`W` / `kW` / `MW`)                                                         | Maximum power this resource injects to the grid (generates/discharges).  |
| `maxImport`         | QVPower (`W` / `kW` / `MW`)                                                         | Maximum power this resource draws from the grid (absorbs/charges).       |
| `telemetryProvider` | text                                                                                | Vendor API / data source identifier for telemetry.                       |
| `commissioningDate` | date-time                                                                           | ISO 8601 date-time the asset was commissioned.                           |
| `location`          | Location                                                                            | Physical location of this asset.                                         |
| `serialNumber`      | text                                                                                | Manufacturer-assigned device serial number from the equipment nameplate. |
| `inspection`        | object                                                                              | Commissioning / safety inspection record for the asset.                  |
| `aggregator`        | object                                                                              | Third-party flexibility / demand-response enrolment for this asset.      |
| `connectorType`     | `Type1` / `Type2` / `CCS1` / `CCS2` / `CHAdeMO` / `GB_T` / `NACS` / `Other`         | Physical connector standard.                                             |
| `controlProtocol`   | `OCPP_1.6` / `OCPP_2.0.1` / `OCPP_2.1` / `ISO_15118_2` / `ISO_15118_20` / `Other`   | EVSE control and smart-charging protocol.                                |
| `v2xProtocol`       | `CHAdeMO_V2G` / `CCS_BPT` / `ISO_15118_20_AC_BPT` / `ISO_15118_20_DC_BPT` / `Other` | Vehicle-to-Grid / V2X protocol.                                          |

**EnergyResourceInverter**

| Field             | Type                             | Description                                |
| ----------------- | -------------------------------- | ------------------------------------------ |
| **`id`** \*       | text                             | Stable identifier for this resource.       |
| **`type`** \*     | text                             | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource   | Topology — child resources.                |
| `parentResources` | list of text                     | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceInverterAttributes | —                                          |

**EnergyResourceInverterAttributes**

| Field                     | Type                                        | Description                                                              |
| ------------------------- | ------------------------------------------- | ------------------------------------------------------------------------ |
| `make`                    | text                                        | Manufacturer (free text).                                                |
| `model`                   | text                                        | Model (free text).                                                       |
| `ratedPower`              | QVPower (`W` / `kW` / `MW`)                 | Manufacturer-rated peak power (nameplate value in principal direction).  |
| `maxExport`               | QVPower (`W` / `kW` / `MW`)                 | Maximum power this resource injects to the grid (generates/discharges).  |
| `maxImport`               | QVPower (`W` / `kW` / `MW`)                 | Maximum power this resource draws from the grid (absorbs/charges).       |
| `telemetryProvider`       | text                                        | Vendor API / data source identifier for telemetry.                       |
| `commissioningDate`       | date-time                                   | ISO 8601 date-time the asset was commissioned.                           |
| `location`                | Location                                    | Physical location of this asset.                                         |
| `serialNumber`            | text                                        | Manufacturer-assigned device serial number from the equipment nameplate. |
| `inspection`              | object                                      | Commissioning / safety inspection record for the asset.                  |
| `aggregator`              | object                                      | Third-party flexibility / demand-response enrolment for this asset.      |
| `ratedApparentPower`      | QVApparentPower (`kVA` / `MVA`)             | Rated apparent power.                                                    |
| `maxReactivePower`        | QVReactivePower (`kVAR` / `MVAR`)           | Maximum reactive power injection (leading / over-excited).               |
| `minReactivePower`        | QVReactivePower (`kVAR` / `MVAR`)           | Maximum reactive power absorption (lagging / under-excited).             |
| `rideThroughCategory`     | `CategoryI` / `CategoryII` / `CategoryIII`  | Abnormal operating performance category.                                 |
| `operatingMode`           | `GridFollowing` / `GridForming` / `Standby` | Inverter grid-interaction mode.                                          |
| `voltVarEnabled`          | yes / no                                    | Volt-VAr curve active.                                                   |
| `freqDroopEnabled`        | yes / no                                    | Frequency-Watt droop active.                                             |
| `enterServiceRampTimeSec` | number                                      | Seconds to ramp from 0 to rated power after reconnection.                |

**QVApparentPower**

| Field          | Type          | Description |
| -------------- | ------------- | ----------- |
| **`value`** \* | number        | —           |
| **`unit`** \*  | `kVA` / `MVA` | —           |

**QVReactivePower**

| Field          | Type            | Description |
| -------------- | --------------- | ----------- |
| **`value`** \* | number          | —           |
| **`unit`** \*  | `kVAR` / `MVAR` | —           |

**EnergyResourceLoad**

| Field             | Type                                                      | Description                                |
| ----------------- | --------------------------------------------------------- | ------------------------------------------ |
| **`id`** \*       | text                                                      | Stable identifier for this resource.       |
| **`type`** \*     | `SMART_HVAC` / `SMART_WATER_HEATER` / `CONTROLLABLE_LOAD` | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource                            | Topology — child resources.                |
| `parentResources` | list of text                                              | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceLoadAttributes                              | —                                          |

**EnergyResourceLoadAttributes**

| Field               | Type                                                                                | Description                                                              |
| ------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `make`              | text                                                                                | Manufacturer (free text).                                                |
| `model`             | text                                                                                | Model (free text).                                                       |
| `ratedPower`        | QVPower (`W` / `kW` / `MW`)                                                         | Manufacturer-rated peak power (nameplate value in principal direction).  |
| `maxExport`         | QVPower (`W` / `kW` / `MW`)                                                         | Maximum power this resource injects to the grid (generates/discharges).  |
| `maxImport`         | QVPower (`W` / `kW` / `MW`)                                                         | Maximum power this resource draws from the grid (absorbs/charges).       |
| `telemetryProvider` | text                                                                                | Vendor API / data source identifier for telemetry.                       |
| `commissioningDate` | date-time                                                                           | ISO 8601 date-time the asset was commissioned.                           |
| `location`          | Location                                                                            | Physical location of this asset.                                         |
| `serialNumber`      | text                                                                                | Manufacturer-assigned device serial number from the equipment nameplate. |
| `inspection`        | object                                                                              | Commissioning / safety inspection record for the asset.                  |
| `aggregator`        | object                                                                              | Third-party flexibility / demand-response enrolment for this asset.      |
| `controlProtocol`   | `OpenADR_2.0b` / `OCPP_2.0.1` / `SunSpec_Modbus` / `EEBus` / `Modbus` / `Other`     | Demand-response / control protocol supported by this load device.        |
| `loadCategory`      | `Heating` / `Cooling` / `WaterHeating` / `Lighting` / `EV` / `Industrial` / `Other` | Functional category of this load.                                        |

**EnergyResourceNetwork**

| Field             | Type                                  | Description                                |
| ----------------- | ------------------------------------- | ------------------------------------------ |
| **`id`** \*       | text                                  | Stable identifier for this resource.       |
| **`type`** \*     | `DT` / `BUS` / `FEEDER` / `MICROGRID` | Asset-class discriminator.                 |
| `subResources`    | list of text or EnergyResource        | Topology — child resources.                |
| `parentResources` | list of text                          | Upward topology — ids of parent resources. |
| `attributes`      | EnergyResourceNetworkAttributes       | —                                          |

**EnergyResourceNetworkAttributes**

| Field               | Type                        | Description                                                              |
| ------------------- | --------------------------- | ------------------------------------------------------------------------ |
| `make`              | text                        | Manufacturer (free text).                                                |
| `model`             | text                        | Model (free text).                                                       |
| `ratedPower`        | QVPower (`W` / `kW` / `MW`) | Manufacturer-rated peak power (nameplate value in principal direction).  |
| `maxExport`         | QVPower (`W` / `kW` / `MW`) | Maximum power this resource injects to the grid (generates/discharges).  |
| `maxImport`         | QVPower (`W` / `kW` / `MW`) | Maximum power this resource draws from the grid (absorbs/charges).       |
| `telemetryProvider` | text                        | Vendor API / data source identifier for telemetry.                       |
| `commissioningDate` | date-time                   | ISO 8601 date-time the asset was commissioned.                           |
| `location`          | Location                    | Physical location of this asset.                                         |
| `serialNumber`      | text                        | Manufacturer-assigned device serial number from the equipment nameplate. |
| `inspection`        | object                      | Commissioning / safety inspection record for the asset.                  |
| `aggregator`        | object                      | Third-party flexibility / demand-response enrolment for this asset.      |
| `nominalVoltage`    | QVVoltage (`V` / `kV`)      | Nominal operating voltage.                                               |
| `zone`              | text                        | Operating zone or region identifier used by the utility.                 |
| `substationId`      | text                        | Parent substation identifier per utility records.                        |
| `feederCode`        | text                        | Feeder code per utility records.                                         |

**QVVoltage**

| Field          | Type       | Description |
| -------------- | ---------- | ----------- |
| **`value`** \* | number     | —           |
| **`unit`** \*  | `V` / `kV` | —           |

**ConsumptionProfile**

| Field                       | Type                                                         | Description                                                                                                                                                                                                                                                                            |
| --------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`meterId`** \*            | text                                                         | Matches the id of a METER entry in customerProfile.energyResources\[].                                                                                                                                                                                                                 |
| **`sanctionedLoad`** \*     | QVPower (`W` / `kW` / `MW`)                                  | Sanctioned/approved import load.                                                                                                                                                                                                                                                       |
| `sanctionedExportLoad`      | QVPower (`W` / `kW` / `MW`)                                  | Sanctioned/approved grid export limit.                                                                                                                                                                                                                                                 |
| `billingCycleDay`           | integer                                                      | Day of month on which the billing cycle resets.                                                                                                                                                                                                                                        |
| `contractMaxDemand`         | QVPower (`W` / `kW` / `MW`)                                  | Maximum demand contracted with the utility for this connection.                                                                                                                                                                                                                        |
| **`tariffCategoryCode`** \* | text                                                         | Billing/tariff category code assigned by the utility.                                                                                                                                                                                                                                  |
| `premisesType`              | `Residential` / `Commercial` / `Industrial` / `Agricultural` | Type of premises at the metering point.                                                                                                                                                                                                                                                |
| `connectionType`            | `Single-phase` / `Three-phase`                               | Electrical connection type.                                                                                                                                                                                                                                                            |
| `paymentMode`               | `POSTPAID` / `PREPAID`                                       | Billing/payment modality.                                                                                                                                                                                                                                                              |
| `serviceStatus`             | `active` / `suspended` / `closed`                            | Lifecycle state of the service connection (the UsagePoint), not of the meter device itself. 'active' = currently energised and billable; 'suspended' = temporarily disconnected (non-payment, inspection, fault) with the contract still on record; 'closed' = permanently terminated. |

## Versions

Every published version stays reachable at its canonical URL — clients pin a version explicitly. Click a version for its full field reference.

| Version                                             | Status      | Notes                                                                                              | Files                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [v1.2](/docs/schemas/electricitycredential/v1.2.md) | **Current** | Composable EnergyResource kinds (7 typed discriminants); directional power fields; EV charger kind | [schema.json](https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/schema.json) · [attributes.yaml](https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.2/attributes.yaml) · [examples](https://github.com/India-Energy-Stack/ies-accelerator/tree/main/schemas/ElectricityCredential/v1.2/examples/README.md) |
| [v1.1](/docs/schemas/electricitycredential/v1.1.md) | Previous    | Unified `energyResources[]`, multi-meter topology support                                          | [schema.json](https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.1/schema.json) · [attributes.yaml](https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.1/attributes.yaml) · [examples](https://github.com/India-Energy-Stack/ies-accelerator/tree/main/schemas/ElectricityCredential/v1.1/examples/README.md) |
| [v1.0](/docs/schemas/electricitycredential/v1.0.md) | Deprecated  | Separate consumption/generation/storage profile arrays                                             | [schema.json](https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.0/schema.json) · [attributes.yaml](https://india-energy-stack.github.io/ies-accelerator/schemas/ElectricityCredential/v1.0/attributes.yaml) · [examples](https://github.com/India-Energy-Stack/ies-accelerator/tree/main/schemas/ElectricityCredential/v1.0/examples/README.md) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://india-energy-stack.gitbook.io/docs/schemas/electricitycredential.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
