ERCOT Interconnection Queue

Overview

The ERCOT interconnection queue endpoint provides access to real-time data from the Electric Reliability Council of Texas (ERCOT) interconnection queue, which serves most of Texas.

ERCOT Coverage: Contains 2,200+ projects primarily in Texas (99%). Top technologies: Solar (800+ projects), Wind (400+ projects), Battery Storage (350+ projects).

Hybrid Projects: ERCOT represents each technology component of hybrid projects (e.g., solar + storage) as separate rows in their Excel source files with different INR numbers. Our API maintains this structure. See our comprehensive guide on hybrid project handling for details.

Endpoint

curl -H "x-api-key: your_api_key_here" \
  "https://api.cleanview.co/api/v1/interconnection/ercot?limit=50"

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	1000	Number of records to return (50-5000)
`offset`	integer	0	Number of records to skip
`state`	string	-	Filter by state code (primarily TX) - supports comma-separated
`technology`	string	-	Filter by standardized technology type - supports comma-separated
`status`	string	-	Filter by standardized status
`min_capacity`	number	-	Minimum capacity in MW
`max_capacity`	number	-	Maximum capacity in MW
`developer`	string	-	Filter by developer name (supports partial matches)

Technology Options

Use standardized technology names. See our Interconnection Reference for all available options.

Technology	Count	Description
`Solar`	800+	Solar photovoltaic projects
`Wind`	400+	Wind turbine projects
`Battery`	350+	Battery energy storage systems
`Natural Gas`	150+	Natural gas generation
`Other`	300+	Other technologies

Status Options

Status	Count	Description
`Planned`	1,500+	Active projects in queue
`Operating`	400+	Commercial operation achieved
`Cancelled`	300+	Withdrawn or terminated

Example Requests

Get Active Solar Projects in Texas

curl -H "x-api-key: your_api_key_here" \
  "https://api.cleanview.co/api/v1/interconnection/ercot?technology=Solar&status=Planned&state=TX&limit=50"

Returns active solar projects in the ERCOT queue. Uses technology=Solar for standardized filtering.

Get Large Wind Projects (>200 MW)

curl -H "x-api-key: your_api_key_here" \
  "https://api.cleanview.co/api/v1/interconnection/ercot?technology=Wind&min_capacity=200&limit=50"

Finds large-scale wind projects. Uses technology=Wind for wind turbine projects.

Get Battery Storage Projects

curl -H "x-api-key: your_api_key_here" \
  "https://api.cleanview.co/api/v1/interconnection/ercot?technology=Battery&limit=50"

Filters for battery energy storage projects.

Get Projects by Multiple Technologies

curl -H "x-api-key: your_api_key_here" \
  "https://api.cleanview.co/api/v1/interconnection/ercot?technology=Solar,Wind,Battery&limit=50"

Uses comma-separated values for multiple technology filtering.

Response Schema

{
  "iso": "ERCOT",
  "summary": {
    "limit": 50,
    "offset": 0,
    "total_results": 2234,
    "has_more": true,
    "current_page": 1,
    "total_pages": 45
  },
  "filters": {
    "state": null,
    "technology": null,
    "status": null,
    "min_capacity": null,
    "max_capacity": null,
    "developer": null
  },
  "data": [
    {
      "iso": "ERCO",
      "queue_id": "12INR0059b",
      "project_name": "HOVEY (Barilla Solar 1B)",
      "capacity_mw": 7.4,
      "technology": "Photovoltaic Solar",
      "fuel": "SOL",
      "status": "Planned",
      "detailed_status": "Active",
      "operating_date": "2025-11-30T08:00:00.000Z",
      "request_date": null,
      "county": "Pecos",
      "state": "TX",
      "queue_position": null,
      "interconnecting_entity": "First Solar",
      "developer": "Unable to find",
      "gim_study_phase": null,
      "screening_study_started": null,
      "screening_study_complete": null,
      "fis_requested": null,
      "fis_approved": null,
      "ia_signed": "2013-12-26T08:00:00.000Z",
      "poi_location": "60385 Solstice 138kV",
      "cdr_reporting_zone": "WEST",
      "technology_display": "Photovoltaic Solar",
      "fuel_display": "Solar",
      "balancing_authority_code": "ERCO",
      "technology_normalized": "Solar",
      "inr_request_number": "12INR0059b",
      "projected_cod": "2025-11-30T08:00:00.000Z",
      "changes_from_last_report": null,
      "proof_of_site_control": null,
      "economic_study_required": null,
      "financial_security": true,
      "air_permit": null,
      "ghg_permit": null,
      "water_availability": null,
      "meets_691_requirements": null,
      "meets_69_requirements": null,
      "meets_59_requirements": null,
      "construction_start": null,
      "construction_end": null,
      "approved_for_energization": "2015-09-02T07:00:00.000Z",
      "approved_for_synchronization": "2015-09-14T07:00:00.000Z",
      "comment": null,
      "size_category": "Small",
      "model_ready_date": "2015-09-02T07:00:00.000Z",
      "change_indicators": null,
      "approved_for_commercial_operation": null,
      "status_last_updated": null
    }
  ]
}

Complete Upstream Data: Each project includes all 49 database columns from ERCOT’s interconnection queue at the top level. This provides complete transparency with both standardized fields (normalized across all ISOs) and ERCOT-specific raw fields like inr_request_number, screening_study_required, and planned_outage_season.

Response Fields

Core Identification Fields

Field	Type	Description
`iso`	string	Always “ERCO” for ERCOT data
`queue_id`	string	Unique ERCOT queue identifier
`project_name`	string	Official project name in ERCOT queue
`inr_request_number`	string	Interconnection Request (INR) number
`balancing_authority_code`	string	Always “ERCO”
`queue_position`	string	Queue position (null - not provided by ERCOT)

Capacity & Technology

Field	Type	Description
`capacity_mw`	number	Project nameplate capacity in MW
`technology`	string	Technology type (e.g., “Photovoltaic Solar”, “Wind”)
`technology_display`	string	ERCOT’s display technology description
`technology_normalized`	string	Standardized technology for cross-ISO filtering
`fuel`	string	ERCOT fuel code (SOL, WND, GAS, etc.)
`fuel_display`	string	Human-readable fuel type description

Project Status & Dates

Field	Type	Description
`status`	string	Standardized status (Planned, Operating, Cancelled)
`detailed_status`	string	Original ERCOT status (e.g., “Active”)
`operating_date`	date	Expected/actual commercial operation date
`projected_cod`	date	Projected commercial operation date
`request_date`	date	Interconnection request date (often null)
`status_last_updated`	date	Date status was last updated

Location

Field	Type	Description
`state`	string	State code (primarily TX)
`county`	string	County name where project is located

Grid Connection

Field	Type	Description
`interconnecting_entity`	string	Interconnection customer/developer name
`poi_location`	string	Point of Interconnection with voltage level
`cdr_reporting_zone`	string	CDR zone (NORTH, SOUTH, WEST, HOUSTON)

Study Process & Milestones

Field	Type	Description
`gim_study_phase`	string	Generation Interconnection & Model (GIM) study phase
`screening_study_started`	date	Screening study start date
`screening_study_complete`	date	Screening study completion date
`fis_requested`	date	Facility Impact Study (FIS) requested date
`fis_approved`	date	Facility Impact Study approved date
`ia_signed`	date	Interconnection Agreement (IA) signed date

Project Requirements & Permits

Field	Type	Description
`proof_of_site_control`	boolean	Site control documentation status
`economic_study_required`	boolean	Whether economic study is required
`financial_security`	boolean	Financial security posting status
`air_permit`	boolean	Air quality permit status
`ghg_permit`	boolean	Greenhouse gas permit status
`water_availability`	boolean	Water availability documentation status
`meets_691_requirements`	boolean	Meets Planning Guide Section 6.9.1 requirements
`meets_69_requirements`	boolean	Meets Planning Guide Section 6.9 requirements
`meets_59_requirements`	boolean	Meets Planning Guide Section 5.9 requirements

Construction & Energization

Field	Type	Description
`construction_start`	date	Construction start date
`construction_end`	date	Construction completion date
`approved_for_energization`	date	Date approved for energization
`approved_for_synchronization`	date	Date approved for synchronization to grid
`approved_for_commercial_operation`	date	Date approved for commercial operation
`model_ready_date`	date	Date project model was ready

Project Tracking

Field	Type	Description
`size_category`	string	Project size classification (Small, Medium, Large)
`changes_from_last_report`	string	Notable changes since last queue report
`change_indicators`	string	Indicators of project changes
`comment`	string	Additional ERCOT comments or notes

Developer Information

Field	Type	Description
`developer`	string	Developer name from Cleanview enrichment

Data Updates: ERCOT queue data is updated weekly. The API reflects the most recent Generation Interconnection Request (GIR) data available from ERCOT.

Unique Features: ERCOT data includes detailed point of interconnection information (poi_location) and congestion zone mapping (cdr_reporting_zone), making it excellent for grid analysis.

Missing Coordinates: ERCOT data does not include latitude/longitude coordinates. Use the county, poi_location, and cdr_reporting_zone fields for geographic analysis.

Authorizations

x-api-key

string

header

required

API key authentication using x-api-key header

Query Parameters

limit

integer

default:50

Number of records to return

Required range: 50 <= x <= 5000

offset

integer

default:0

Number of records to skip

state

string

Filter by state code (TX)

technology

string

Filter by technology type

min_capacity

number

Minimum capacity in MW

max_capacity

number

Maximum capacity in MW

Response

Successful response with ERCOT interconnection queue data

iso

string

Example:

"ERCOT"

summary

object

Summary metadata for pagination

Show child attributes

summary.limit

integer

Number of records per page

summary.offset

integer

Number of records to skip

summary.total_results

integer

Total number of records matching the query

summary.has_more

boolean

Whether additional records exist beyond this page

summary.current_page

integer

Current page number (1-indexed)

summary.total_pages

integer

Total number of pages available

filters

object

Applied filters for the request

data

object[]

Array of interconnection queue records

Show child attributes

data.iso

string

Example:

"PJM"

data.queue_id

string

Example:

"AB1-234"

data.project_name

string

Example:

"Sample Solar Project"

data.capacity_mw

number

Example:

156.04

data.technology

string

Example:

"Solar"

data.status

string

Example:

"Planned"

data.state

string

Example:

"PA"

data.county

string

Example:

"Allegheny"

Overview

EIA Data

Interconnection Queues

Projects

Overview

Endpoint

Query Parameters

Technology Options

Status Options

Example Requests

Response Schema

Response Fields

Core Identification Fields

Capacity & Technology

Project Status & Dates

Location

Grid Connection

Study Process & Milestones

Project Requirements & Permits

Construction & Energization

Project Tracking

Developer Information

Authorizations

Query Parameters

Response

Overview

EIA Data

Interconnection Queues

Projects

​Overview

​Endpoint

​Query Parameters

​Technology Options

​Status Options

​Example Requests

​Response Schema

​Response Fields

​Core Identification Fields

​Capacity & Technology

​Project Status & Dates

​Location

​Grid Connection

​Study Process & Milestones

​Project Requirements & Permits

​Construction & Energization

​Project Tracking

​Developer Information

Authorizations

Query Parameters

Response

Overview

Endpoint

Query Parameters

Technology Options

Status Options

Example Requests

Response Schema

Response Fields

Core Identification Fields

Capacity & Technology

Project Status & Dates

Location

Grid Connection

Study Process & Milestones

Project Requirements & Permits

Construction & Energization

Project Tracking

Developer Information