eflSnapshots

Retrieve EFL snapshots.

This query returns EFL snapshots containing all data needed to render an Electricity Facts Label without additional calculations.

Usage: - Query by version to get a specific snapshot (other filters are ignored) - Or provide productCode (required) with optional filters (serviceProvider, loadZone, activeAt) - Use activeAt to find snapshots that were active at a specific date/time - If activeAt is not provided, only currently active snapshots are returned

Returns an empty list if no snapshots match the criteria (unless version is specified, which raises an error if not found).

Arguments

activeAt : DateTime

Filter snapshots active at this date/time (ISO-8601 format). If not provided, returns currently active snapshots.

loadZone : LoadZone

Filter by load zone.

productCode : String

Filter by product code. Required when version is not provided.

serviceProvider : ServiceProvider

Filter by TDSP (Transmission/Distribution Service Provider).

version : String

Retrieve the EFL snapshot with this exact version identifier. If provided, other filters are ignored.

Returns

[EFLSnapshotType]

An EFL snapshot containing all data needed to render an Electricity Facts Label.

Possible Errors

Allowed Viewers

Customer

Partner User

Third party

Required Permissions

Can query fact sheet

Query Complexity

Examples

The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

query EflSnapshots(
  $activeAt: DateTime,
  $loadZone: LoadZone,
  $productCode: String,
  $serviceProvider: ServiceProvider,
  $version: String
) {
  eflSnapshots(
    activeAt: $activeAt,
    loadZone: $loadZone,
    productCode: $productCode,
    serviceProvider: $serviceProvider,
    version: $version
  ) {
    activeFrom
    activeTo
    id
    loadZone
    productCode
    serviceProvider
    snapshotData {
      ...EFLSnapshotDataTypeFragment
    }
    templateVersion
    version
  }
}

{
  "activeAt": "2001-05-17T16:06:30.019349+00:00",
  "loadZone": "LZ_HOUSTON",
  "productCode": "into-leader-need-college-past",
  "serviceProvider": "AEP_TCC",
  "version": "western-option-skin-executive-choice"
}

{
  "data": {
    "eflSnapshots": [
      {
        "activeFrom": "1970-05-14T02:09:01.102786+00:00",
        "activeTo": "2025-07-15T17:54:19.262349+00:00",
        "id": "25980254",
        "loadZone": "LZ_HOUSTON",
        "productCode": "international-require-mention-condition-thought",
        "serviceProvider": "AEP_TCC",
        "snapshotData": EFLSnapshotDataType,
        "templateVersion": "last-mouth-hair-deal-be",
        "version": "blue-Mrs-case-however-little"
      }
    ]
  }
}