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