Power and grid

One electricity project, with planned capacity, current status and source evidence.

One row is

One electricity project, with planned capacity, current status and source evidence

Example response

Trimmed real output. No key needed.

GET /v1/datasets/power/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "projects": [
      {
        "id": "us-caiso:22",
        "sourceId": "us-caiso",
        "sourceProjectId": "22",
        "kind": "queue",
        "name": "MONTEZUMA (HIGH WINDS III)",
        "country": "US",
        "region": "CAISO",
        "state": "CA",
        "county": "SOLANO",
        "zone": "Northern",
        "developer": null,
        "utility": "PGAE",
        "fuel": "hybrid",
        "technology": "Wind Turbine + Storage",
        "status": "active",
        "statusRaw": "ACTIVE",
        "capacityMw": 38,
        "requestedDate": "2003-11-18",
        "proposedDate": "2024-04-01",
        "completedDate": null,
        "withdrawnDate": null,
        "period": null,
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "sourceLocator": "Grid GenerationQueue!row 2",
        "confidence": 1,
        "evidence": {
          "Project Name": "MONTEZUMA (HIGH WINDS III)",
          "Queue Position": 22,
          "Interconnection Request Receive Date": 37943,
          "Queue Date": 37943.3333333333,
          "Application Status": "ACTIVE",
          "Study Process": "AMEND 39",
          "Type-1": "Wind Turbine",
          "Type-2": "Storage",
          "Type-3": null,
          "Fuel-1": "Wind Turbine",
          "Fuel-2": "Battery",
          "Fuel-3": null,
          "MW-1": 38,
          "MW-2": 38,
          "MW-3": null,
          "Net MWs to Grid": 38,
          "Full Capacity, Partial or Energy Only (FC/P/EO)": "Partial Capacity",
          "TPD Allocation Percentage": 50,
          "Off-Peak Deliverability and Economic Only": "Off-Peak Deliverability",
          "TPD Allocation Group": "Group D",
          "County": "SOLANO",
          "State": "CA",
          "Utility": "PGAE",
          "PTO Study Region": "Northern",
          "Station or Transmission Line": "Birds Landing 230 kV",
          "Proposed On-line Date (as filed with IR)": 38533.2916666667,
          "Current On-line Date": 45383.2916666667,
          "Suspension Status": null,
          "Feasibility Study or Supplemental Review": null,
          "System Impact Study or Phase I Cluster Study": "Complete",
          "Facilities Study (FAS) or Phase II Cluster Study": "Complete",
          "Optional Study (OS)": null,
          "Interconnection Agreement Status": "Executed"
        },
        "metrics": {
          "capacityBasis": "net MW to grid",
          "pointOfInterconnection": "Birds Landing 230 kV",
          "mwInService": null,
          "mfoMw": null,
          "interconnectionAgreement": "Executed"
        },
        "historical": false,
        "snapshotId": "us-caiso:22:1",
        "revision": 1,
        "entities": []
      },
      {
        "id": "us-caiso:32",
        "sourceId": "us-caiso",
        "sourceProjectId": "32",
        "kind": "queue",
        "name": "TULE WIND",
        "country": "US",
        "region": "CAISO",
        "state": "CA",
        "county": "SAN DIEGO",
        "zone": "SDGE",
        "developer": null,
        "utility": "SDGE",
        "fuel": "hybrid",
        "technology": "Wind Turbine + Storage",
        "status": "active",
        "statusRaw": "ACTIVE",
        "capacityMw": 193.8,
        "requestedDate": "2004-05-24",
        "proposedDate": "2030-10-31",
        "completedDate": null,
        "withdrawnDate": null,
        "period": null,
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "sourceLocator": "Grid GenerationQueue!row 3",
        "confidence": 1,
        "evidence": {
          "Project Name": "TULE WIND",
          "Queue Position": 32,
          "Interconnection Request Receive Date": 38119,
          "Queue Date": 38131.2916666667,
          "Application Status": "ACTIVE",
          "Study Process": "Serial LGIP",
          "Type-1": "Wind Turbine",
          "Type-2": "Storage",
          "Type-3": null,
          "Fuel-1": "Wind Turbine",
          "Fuel-2": "Battery",
          "Fuel-3": null,
          "MW-1": 127.6,
          "MW-2": 131.6,
          "MW-3": null,
          "Net MWs to Grid": 193.8,
          "Full Capacity, Partial or Energy Only (FC/P/EO)": "Partial Capacity",
          "TPD Allocation Percentage": 23,
          "Off-Peak Deliverability and Economic Only": "Off-Peak Deliverability",
          "TPD Allocation Group": "Group B",
          "County": "SAN DIEGO",
          "State": "CA",
          "Utility": "SDGE",
          "PTO Study Region": "SDGE",
          "Station or Transmission Line": "Boulevard East Substation 138 kV",
          "Proposed On-line Date (as filed with IR)": 39326.2916666667,
          "Current On-line Date": 47787.2916666667,
          "Suspension Status": null,
          "Feasibility Study or Supplemental Review": "Waived",
          "System Impact Study or Phase I Cluster Study": "Complete",
          "Facilities Study (FAS) or Phase II Cluster Study": "Complete",
          "Optional Study (OS)": "None",
          "Interconnection Agreement Status": "Executed"
        },
        "metrics": {
          "capacityBasis": "net MW to grid",
          "pointOfInterconnection": "Boulevard East Substation 138 kV",
          "mwInService": null,
          "mfoMw": null,
          "interconnectionAgreement": "Executed"
        },
        "historical": false,
        "snapshotId": "us-caiso:32:1",
        "revision": 1,
        "entities": []
      },
      {
        "id": "us-caiso:54",
        "sourceId": "us-caiso",
        "sourceProjectId": "54",
        "kind": "queue",
        "name": "MIDWAY PEAKING",
        "country": "US",
        "region": "CAISO",
        "state": "CA",
        "county": "FRESNO",
        "zone": "Fresno",
        "developer": null,
        "utility": "PGAE",
        "fuel": "hybrid",
        "technology": "Gas Turbine + Storage",
        "status": "active",
        "statusRaw": "ACTIVE",
        "capacityMw": 119.9,
        "requestedDate": "2005-01-12",
        "proposedDate": "2027-06-30",
        "completedDate": null,
        "withdrawnDate": null,
        "period": null,
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "sourceLocator": "Grid GenerationQueue!row 4",
        "confidence": 1,
        "evidence": {
          "Project Name": "MIDWAY PEAKING",
          "Queue Position": 54,
          "Interconnection Request Receive Date": 38364,
          "Queue Date": 38364.3333333333,
          "Application Status": "ACTIVE",
          "Study Process": "Serial LGIP",
          "Type-1": "Gas Turbine",
          "Type-2": "Storage",
          "Type-3": null,
          "Fuel-1": "Natural Gas",
          "Fuel-2": "Battery",
          "Fuel-3": null,
          "MW-1": 119.9,
          "MW-2": 119.9,
          "MW-3": null,
          "Net MWs to Grid": 119.9,
          "Full Capacity, Partial or Energy Only (FC/P/EO)": "Full Capacity",
          "TPD Allocation Percentage": null,
          "Off-Peak Deliverability and Economic Only": "Off-Peak Deliverability",
          "TPD Allocation Group": null,
          "County": "FRESNO",
          "State": "CA",
          "Utility": "PGAE",
          "PTO Study Region": "Fresno",
          "Station or Transmission Line": "Panoche Substation",
          "Proposed On-line Date (as filed with IR)": 39600.2916666667,
          "Current On-line Date": 46568.2916666667,
          "Suspension Status": null,
          "Feasibility Study or Supplemental Review": "Waived",
          "System Impact Study or Phase I Cluster Study": "Complete",
          "Facilities Study (FAS) or Phase II Cluster Study": "Re-Study",
          "Optional Study (OS)": "None",
          "Interconnection Agreement Status": "Executed"
        },
        "metrics": {
          "capacityBasis": "net MW to grid",
          "pointOfInterconnection": "Panoche Substation",
          "mwInService": null,
          "mfoMw": null,
          "interconnectionAgreement": "Executed"
        },
        "historical": false,
        "snapshotId": "us-caiso:54:1",
        "revision": 1,
        "entities": []
      },
      {
        "id": "us-caiso:1A",
        "sourceId": "us-caiso",
        "sourceProjectId": "1A",
        "kind": "queue",
        "name": "OTAY MESA GENERATING PROJECT",
        "country": "US",
        "region": "CAISO",
        "state": "CA",
        "county": "SAN DIEGO",
        "zone": null,
        "developer": null,
        "utility": "SDGE",
        "fuel": "gas",
        "technology": "Combined Cycle",
        "status": "completed",
        "statusRaw": "COMPLETED",
        "capacityMw": 550,
        "requestedDate": "1999-11-01",
        "proposedDate": "2002-03-01",
        "completedDate": "2009-10-02",
        "withdrawnDate": null,
        "period": null,
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "sourceLocator": "Completed Generation Projects!row 2",
        "confidence": 1,
        "evidence": {
          "Project Name": "OTAY MESA GENERATING PROJECT",
          "Queue Position": "1A",
          "Interconnection Request Receive Date": 36465,
          "Queue Date": 36465.3333333333,
          "Application Status": "COMPLETED",
          "Study Process": "Pre- Amend. 39",
          "Type-1": "Combined Cycle",
          "Type-2": null,
          "Type-3": null,
          "Fuel-1": "Natural Gas",
          "Fuel-2": null,
          "Fuel-3": null,
          "MW-1": 550,
          "MW-2": null,
          "MW-3": null,
          "Net MWs to Grid": 550,
          "Full Capacity, Partial or Energy Only (FC/P/EO)": null,
          "TPD Allocation Percentage": null,
          "Off-Peak Deliverability and Economic Only": "Off-Peak Deliverability",
          "TPD Allocation Group": null,
          "County": "SAN DIEGO",
          "State": "CA",
          "Utility": "SDGE",
          "PTO Study Region": null,
          "Station or Transmission Line": "Otay Mesa Switchyard 230 kV",
          "Proposed On-line Date (as filed with IR)": 37316.3333333333,
          "Actual On-line Date": 40088.2916666667,
          "Feasibility Study or Supplemental Review": null,
          "System Impact Study or Phase I Cluster Study": "Complete",
          "Facilities Study (FAS) or Phase II Cluster Study": "Complete",
          "Optional Study (OS)": null,
          "Interconnection Agreement Status": "Executed"
        },
        "metrics": {
          "capacityBasis": "net MW to grid",
          "pointOfInterconnection": "Otay Mesa Switchyard 230 kV",
          "mwInService": null,
          "mfoMw": null,
          "interconnectionAgreement": "Executed"
        },
        "historical": false,
        "snapshotId": "us-caiso:1A:1",
        "revision": 1,
        "entities": []
      },
      {
        "id": "us-caiso:2",
        "sourceId": "us-caiso",
        "sourceProjectId": "2",
        "kind": "queue",
        "name": "GATEWAY GENERATING FACILITY (FKA CONTRA COSTA POWER PLANT PROJECT)",
        "country": "US",
        "region": "CAISO",
        "state": "CA",
        "county": "CONTRA COSTA",
        "zone": null,
        "developer": null,
        "utility": "PGAE",
        "fuel": "gas",
        "technology": "Combined Cycle",
        "status": "completed",
        "statusRaw": "COMPLETED",
        "capacityMw": 590,
        "requestedDate": "2000-02-03",
        "proposedDate": "2007-11-28",
        "completedDate": "2009-01-06",
        "withdrawnDate": null,
        "period": null,
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "sourceLocator": "Completed Generation Projects!row 3",
        "confidence": 1,
        "evidence": {
          "Project Name": "GATEWAY GENERATING FACILITY (FKA CONTRA COSTA POWER PLANT PROJECT)",
          "Queue Position": 2,
          "Interconnection Request Receive Date": 36382,
          "Queue Date": 36559.3333333333,
          "Application Status": "COMPLETED",
          "Study Process": "Pre- Amend. 39",
          "Type-1": "Combined Cycle",
          "Type-2": null,
          "Type-3": null,
          "Fuel-1": "Natural Gas",
          "Fuel-2": null,
          "Fuel-3": null,
          "MW-1": 590,
          "MW-2": null,
          "MW-3": null,
          "Net MWs to Grid": 590,
          "Full Capacity, Partial or Energy Only (FC/P/EO)": null,
          "TPD Allocation Percentage": null,
          "Off-Peak Deliverability and Economic Only": "Off-Peak Deliverability",
          "TPD Allocation Group": null,
          "County": "CONTRA COSTA",
          "State": "CA",
          "Utility": "PGAE",
          "PTO Study Region": null,
          "Station or Transmission Line": "Contra Costa Power Plant 230 kV bus",
          "Proposed On-line Date (as filed with IR)": 39414.3333333333,
          "Actual On-line Date": 39819.3333333333,
          "Feasibility Study or Supplemental Review": null,
          "System Impact Study or Phase I Cluster Study": "Complete",
          "Facilities Study (FAS) or Phase II Cluster Study": "Complete",
          "Optional Study (OS)": null,
          "Interconnection Agreement Status": "Executed"
        },
        "metrics": {
          "capacityBasis": "net MW to grid",
          "pointOfInterconnection": "Contra Costa Power Plant 230 kV bus",
          "mwInService": null,
          "mfoMw": null,
          "interconnectionAgreement": "Executed"
        },
        "historical": false,
        "snapshotId": "us-caiso:2:1",
        "revision": 1,
        "entities": []
      }
    ],
    "total": 5,
    "hasMore": false,
    "nextOffset": null,
    "aggregates": [],
    "rates": [],
    "exposure": [],
    "filters": {
      "countries": [
        "US"
      ],
      "regions": [],
      "fuels": [],
      "statuses": []
    },
    "generatedAt": "2026-10-04T01:00:00.000Z",
    "coverage": [
      {
        "id": "us-caiso",
        "country": "US",
        "region": "CAISO",
        "kind": "queue",
        "role": "direct",
        "status": "current",
        "reason": null,
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "records": 5,
        "nextPollAt": null
      }
    ],
    "access": "full",
    "locked": {
      "projects": 0,
      "aggregates": 0,
      "rates": 0,
      "exposure": 0
    }
  },
  "meta": {
    "dataset": "power",
    "asOf": null,
    "source": [
      {
        "id": "power-registers",
        "attribution": "Public electricity grid registers",
        "licence": "Use subject to Gloom Datasets terms"
      },
      {
        "id": "government-power",
        "attribution": "Government open data",
        "licence": "Use subject to Gloom Datasets terms"
      }
    ],
    "historyStarts": null,
    "coverage": [
      {
        "id": "us-caiso",
        "country": "US",
        "region": "CAISO",
        "kind": "queue",
        "role": "direct",
        "status": "current",
        "reason": null,
        "sourceUrl": "https://www.caiso.com/documents/publicqueuereport.xlsx",
        "asOf": null,
        "observedAt": "2026-10-04T01:00:00.000Z",
        "records": 5,
        "nextPollAt": null
      }
    ],
    "lastUpdated": "2026-10-04T01:00:00.000Z",
    "disclaimer": "Queue requests are not committed capacity. Historical benchmarks are separate from current totals."
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/power/board25 credits

Electricity projects, capacity, queue rates and utility exposure. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters16 rows
Parameter

country

In

query

Type

string

Parameter

region

In

query

Type

string

Parameter

fuel

In

query

Type

string

Parameter

status

In

query

Type

string

Parameter

symbol

In

query

Type

string ^[A-Za-z0-9.:-]{1,32}$

Notes

Company symbol; normalized to uppercase.

Parameter

search

In

query

Type

string

Parameter

sourceId

In

query

Type

string

Parameter

loadClass

In

query

Type

string

Parameter

offset

In

query

Type

integer 0 to 500000

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

sort

In

query

Type

capacityMw, name, region, status, proposedDate, generationMwh, salesMwh, revenueUsd, summerPeakDemandMw, winterPeakDemandMw

Parameter

from

In

query

Type

string ^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$

Parameter

to

In

query

Type

string ^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$

Parameter

kind

In

query

Type

queue, load, capacity, utility

Parameter

direction

In

query

Type

asc, desc

Parameter

historical

In

query

Type

boolean

  • Credits: 25 (bulk x1)
  • Plans: Basic, Desk, Enterprise
GET /v1/power/history2 credits

Observed and published electricity grid history. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters16 rows
Parameter

country

In

query

Type

string

Parameter

region

In

query

Type

string

Parameter

fuel

In

query

Type

string

Parameter

status

In

query

Type

string

Parameter

symbol

In

query

Type

string ^[A-Za-z0-9.:-]{1,32}$

Notes

Company symbol; normalized to uppercase.

Parameter

search

In

query

Type

string

Parameter

sourceId

In

query

Type

string

Parameter

loadClass

In

query

Type

string

Parameter

offset

In

query

Type

integer 0 to 500000

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

sort

In

query

Type

capacityMw, name, region, status, proposedDate, generationMwh, salesMwh, revenueUsd, summerPeakDemandMw, winterPeakDemandMw

Parameter

from

In

query

Type

string ^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$

Parameter

to

In

query

Type

string ^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$

Parameter

kind

In

query

Type

queue, load, capacity, utility

Parameter

direction

In

query

Type

asc, desc

Parameter

historical

In

query

Type

boolean

  • Credits: 2 (history x1)
  • Plans: Basic, Desk, Enterprise
GET /v1/power/projects/{id}5 credits

Electricity project details and retained revisions. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

id

In

path, required

Type

string

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

offset

In

query

Type

integer 0 to 500000

  • Credits: 5 (evidence x1)
  • Plans: Basic, Desk, Enterprise
GET /v1/power/coverage1 credits

Grid register coverage and collection freshness. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters: none.

  • Credits: 1 (lookup x1)
  • Plans: Basic, Desk, Enterprise

Meta fields

Field

dataset

Here

The dataset id

In the example

"power"

Field

asOf

Here

The observation date established by the service; otherwise null

In the example

null

Field

source

Here

Attribution and usage terms of each source

In the example

2 sources

Field

historyStarts

Here

Earliest stored history when established by the service; otherwise null.

In the example

null, not stated yet

Field

coverage

Here

Service-established coverage; null when unavailable.

In the example

[{"id":"us-caiso","country":"US","region":"CAISO","kind":"queue","role":"direct","status":"current","reason":null,"sourceUrl":"https://www.caiso.com/documents/publicqueuereport.xlsx","asOf":null,"observedAt":"2026-10-04T01:00:00.000Z","records":5,"nextPollAt":null}]

Field

lastUpdated

Here

The source update time established by the service; otherwise null

In the example

"2026-10-04T01:00:00.000Z"

Sources

Source

Public electricity grid registers

Usage terms

Use subject to Gloom Datasets terms

Source

Government open data

Usage terms

Use subject to Gloom Datasets terms

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.