> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleanview.co/llms.txt
> Use this file to discover all available pages before exploring further.
# MISO Interconnection Queue
> Access real-time MISO interconnection queue data for all power projects
## Overview
The MISO interconnection queue endpoint provides access to real-time data from Midcontinent Independent System Operator (MISO) interconnection queue. MISO serves 15 states and one Canadian province across the Midwest and South.
**MISO Coverage**: Contains **1,500+ projects** across the Midwest and South. Top technologies: Wind (500+ projects), Solar (400+ projects), Natural Gas (300+ projects), Battery Storage (200+ projects).
## Endpoint
```bash cURL theme={null}
curl -H "x-api-key: your_api_key_here" \
"https://api.cleanview.co/api/v1/interconnection/miso?limit=50"
```
```javascript JavaScript theme={null}
const response = await fetch('https://api.cleanview.co/api/v1/interconnection/miso?limit=50', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
```
```python Python theme={null}
import requests
headers = {'x-api-key': 'your_api_key_here'}
response = requests.get(
'https://api.cleanview.co/api/v1/interconnection/miso?limit=50',
headers=headers
)
data = response.json()
```
## Coverage Area
**States Served**: Arkansas, Illinois, Indiana, Iowa, Kentucky, Louisiana, Michigan, Minnesota, Mississippi, Missouri, Montana, North Dakota, Texas, Wisconsin, and parts of South Dakota. Also serves Manitoba, Canada.
## 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 - 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 Distribution
| Technology | Count | Description |
| ------------- | ----- | ---------------------------------------- |
| `Wind` | 500+ | Wind turbine projects (dominant in MISO) |
| `Solar` | 400+ | Solar photovoltaic projects |
| `Natural Gas` | 300+ | Natural gas generation |
| `Battery` | 200+ | Battery energy storage systems |
| `Other` | 100+ | Other technologies |
### Status Options
| Status | Description |
| ----------- | ----------------------------- |
| `Planned` | Active projects in queue |
| `Operating` | Commercial operation achieved |
| `Cancelled` | Withdrawn or terminated |
## Example Requests
```bash theme={null}
curl -H "x-api-key: your_api_key_here" \
"https://api.cleanview.co/api/v1/interconnection/miso?technology=Wind&state=IL&limit=50"
```
```bash theme={null}
curl -H "x-api-key: your_api_key_here" \
"https://api.cleanview.co/api/v1/interconnection/miso?technology=Solar&min_capacity=100&limit=50"
```
```bash theme={null}
curl -H "x-api-key: your_api_key_here" \
"https://api.cleanview.co/api/v1/interconnection/miso?developer=Apex&limit=50"
```
Filters for projects developed by Apex Clean Energy. Uses partial matching, so "Apex" matches "Apex Clean Energy".
## Response Schema
```json Example Response theme={null}
{
"success": true,
"iso": "MISO",
"summary": {
"limit": 50,
"offset": 0,
"total_results": 3571,
"has_more": true,
"current_page": 1,
"total_pages": 72
},
"filters": {
"state": null,
"technology": null,
"status": null,
"min_capacity": null,
"max_capacity": null,
"developer": null
},
"data": [
{
"iso": "MISO",
"queue_id": "J1000",
"project_name": "Project J1000",
"capacity_mw": 50,
"technology": "Photovoltaic",
"fuel": "Solar",
"status": "Operating",
"detailed_status": "Done",
"operating_date": "2021-10-01T04:00:00.000Z",
"request_date": "2018-03-12T04:00:00.000Z",
"county": "Grant County",
"state": "WI",
"queue_position": null,
"interconnecting_entity": null,
"developer": "Alliant Energy",
"study_cycle": "DPP-2018-APR",
"study_group": "East (ATC)",
"service_type": "NRIS",
"balancing_authority_code": "MISO",
"technology_normalized": "Solar",
"project_id": "J1000",
"request_status": "Done",
"queue_date": "2018-03-12T04:00:00.000Z",
"withdrawn_date": null,
"done_date": "2021-04-02T04:00:00.000Z",
"in_service_date": "2021-10-01T04:00:00.000Z",
"transmission_owner": "American Transmission Co. LLC",
"study_phase": "GIA",
"poi_name": "Nelson Dewey - Lancaster 138kV Line",
"summer_mw": 50,
"winter_mw": 50,
"fuel_type": "Solar",
"facility_type": "Photovoltaic",
"post_gia_status": "In Service",
"negotiated_in_service_date": "2023-03-27T04:00:00.000Z",
"dp1_eris_mw": 50,
"dp1_nris_mw": 50,
"dp2_eris_mw": 50,
"dp2_nris_mw": 50,
"winter_capacity_mw": 50,
"summer_capacity_mw": 50
},
{
"iso": "MISO",
"queue_id": "J1846",
"project_name": "Project J1846",
"capacity_mw": 200,
"technology": "Solar/Battery",
"fuel": "Hybrid",
"status": "Planned",
"detailed_status": "Active",
"operating_date": "2024-09-01T04:00:00.000Z",
"request_date": "2021-07-22T04:00:00.000Z",
"county": "Renville",
"state": "MN",
"queue_position": null,
"interconnecting_entity": null,
"developer": "Ranger Power",
"study_cycle": "DPP-2021",
"study_group": "West",
"service_type": "NRIS",
"balancing_authority_code": "MISO",
"technology_normalized": "Hybrid - Solar + Storage",
"project_id": "J1846",
"request_status": "Active",
"queue_date": "2021-07-22T04:00:00.000Z",
"withdrawn_date": null,
"done_date": null,
"in_service_date": "2024-09-01T04:00:00.000Z",
"transmission_owner": "GREAT RIVER ENERGY",
"study_phase": "Phase 2",
"poi_name": "PANTHER",
"summer_mw": 200,
"winter_mw": 200,
"fuel_type": "Hybrid",
"facility_type": "Solar/Battery",
"post_gia_status": "Not Started",
"negotiated_in_service_date": null,
"dp1_eris_mw": 200,
"dp1_nris_mw": 200,
"dp2_eris_mw": 200,
"dp2_nris_mw": 200,
"winter_capacity_mw": 200,
"summer_capacity_mw": 200
}
]
}
```
**Complete Upstream Data**: Each project includes all 41 database columns from MISO's interconnection queue at the top level. This provides complete transparency with both standardized fields (normalized across all ISOs) and MISO-specific raw fields like `study_phase`, `post_gia_status`, and Decision Point capacity breakdowns.
## Response Fields
### Core Identification Fields
| Field | Type | Description |
| -------------------------- | ------ | ----------------------------------------------- |
| `iso` | string | Always "MISO" for MISO data |
| `queue_id` | string | Unique MISO queue identifier (e.g., "J1000") |
| `project_id` | string | MISO project identifier, same as queue\_id |
| `project_name` | string | Official project name in MISO queue |
| `balancing_authority_code` | string | Always "MISO" |
| `queue_position` | string | Queue position number (typically null for MISO) |
### Capacity & Technology
| Field | Type | Description |
| ----------------------- | ------ | ------------------------------------------------------- |
| `capacity_mw` | number | Project nameplate capacity in MW |
| `summer_capacity_mw` | number | Summer-rated capacity (MISO tracks seasonal variations) |
| `winter_capacity_mw` | number | Winter-rated capacity (MISO tracks seasonal variations) |
| `summer_mw` | number | Summer MW rating from MISO source |
| `winter_mw` | number | Winter MW rating from MISO source |
| `technology` | string | MISO's technology classification (e.g., "Photovoltaic") |
| `technology_normalized` | string | Standardized technology for cross-ISO filtering |
| `fuel` | string | Primary fuel source |
| `fuel_type` | string | Detailed fuel type from MISO source |
| `facility_type` | string | Facility/technology type from MISO source |
### Project Status & Dates
| Field | Type | Description |
| ---------------------------- | ------ | ---------------------------------------------------------- |
| `status` | string | Standardized status (Planned, Operating, Cancelled) |
| `detailed_status` | string | Original MISO status (e.g., "Active", "Done", "Withdrawn") |
| `request_status` | string | Current request status in MISO process |
| `queue_date` | date | Date project entered MISO queue |
| `request_date` | date | Interconnection request submission date |
| `operating_date` | date | Expected/actual commercial operation date |
| `in_service_date` | date | Proposed in-service date |
| `negotiated_in_service_date` | date | Negotiated in-service date (if different from proposed) |
| `done_date` | date | Date project completed MISO process |
| `withdrawn_date` | date | Date project was withdrawn (if applicable) |
### Location
| Field | Type | Description |
| -------- | ------ | ------------------------------------ |
| `state` | string | Two-letter state code |
| `county` | string | County name where project is located |
### Study Process (DPP)
| Field | Type | Description |
| ------------- | ------ | ----------------------------------------------------------------- |
| `study_cycle` | string | Definitive Planning Phase cycle identifier (e.g., "DPP-2018-APR") |
| `study_group` | string | Study group assignment (East, West, Central, South) |
| `study_phase` | string | Current DPP phase (Phase 1, Phase 2, Phase 3, GIA) |
### Decision Point Capacity Allocations
| Field | Type | Description |
| ------------- | ------ | ----------------------------------------------- |
| `dp1_eris_mw` | number | Decision Point 1 ERIS capacity allocation in MW |
| `dp1_nris_mw` | number | Decision Point 1 NRIS capacity allocation in MW |
| `dp2_eris_mw` | number | Decision Point 2 ERIS capacity allocation in MW |
| `dp2_nris_mw` | number | Decision Point 2 NRIS capacity allocation in MW |
### Grid Connection & Service
| Field | Type | Description |
| -------------------- | ------ | ----------------------------------------------------- |
| `service_type` | string | ERIS or NRIS interconnection service designation |
| `transmission_owner` | string | Transmission owner at point of interconnection |
| `poi_name` | string | Point of interconnection name and voltage level |
| `post_gia_status` | string | Generation Interconnection Agreement execution status |
### Developer Information
| Field | Type | Description |
| ------------------------ | ------ | ----------------------------------------------------------- |
| `developer` | string | Developer name from Cleanview enrichment (limited coverage) |
| `interconnecting_entity` | string | Always null - not provided by MISO |
## MISO Queue Terminology
Understanding MISO-specific terms is essential for interpreting interconnection queue data.
### Definitive Planning Phase (DPP)
MISO's three-phase interconnection study process that replaced the old serial queue system in 2018. Projects progress sequentially through Phase 1 (feasibility assessment), Phase 2 (detailed system impact analysis), and Phase 3 (facilities study). Each phase has specific deliverables and timelines designed to accelerate project development.
### Decision Points (DP1, DP2, DP3)
Critical milestones where developers must demonstrate project viability and commit financial security deposits. At each Decision Point, developers must confirm capacity allocations (ERIS/NRIS) and post additional security. Failure to meet Decision Point requirements results in automatic queue withdrawal.
### Service Types
**ERIS (Energy Resource Interconnection Service)**: Energy-only delivery service without capacity delivery rights. ERIS projects can inject energy into the grid but don't receive capacity credit in MISO markets.
**NRIS (Network Resource Interconnection Service)**: Full network service with capacity delivery rights. NRIS projects can both deliver energy and receive capacity credit, but require more extensive system upgrades.
### Study Groups
MISO processes projects in regional cohorts based on queue submission windows. Study groups are typically identified by geographic region (East, West, Central, South) and may include the transmission owner designation (e.g., "East (ATC)", "East (ITC)").
### Study Cycles
Intake windows when MISO accepts new interconnection requests, typically identified by year and month (e.g., "DPP-2021", "DPP-2018-APR"). All projects in a study cycle progress through the DPP phases together.
### Generation Interconnection Agreement (GIA)
Final contractual agreement between generator and MISO governing interconnection terms, construction responsibilities, and operational requirements. Projects reaching "GIA" study phase have completed all technical studies and are finalizing interconnection contracts.
### Seasonal Capacity Ratings
MISO tracks both summer and winter capacity ratings due to significant temperature variations across its multi-state footprint. Solar projects may have lower summer ratings due to heat effects, while wind projects often have higher winter output in the upper Midwest.
**Field Availability**: MISO does not provide `interconnecting_entity` information in their queue data. Use `transmission_owner` for transmission system connection details.
## Raw Fields
### Complete Upstream Data
Each project includes **all database columns** from MISO's interconnection queue **at the top level** of the response. This provides complete transparency and access to specialized MISO fields with a clean, flat structure.
**Complete Data Access**: All 41 fields (19 standardized + 22 ISO-specific) are available at the top level. No nesting, no duplication.
### MISO Raw Fields (22 additional fields)
* `project_id` - MISO queue identifier (e.g., "J1000")
* `queue_date` - Queue entry date
* `request_status` - Raw MISO status value
* `withdrawn_date` - Project withdrawal date (if applicable)
* `done_date` - Project completion date
* `in_service_date` - Proposed in-service date
* `negotiated_in_service_date` - Negotiated ISD (if different from proposed)
* `transmission_owner` - Transmission owner at POI
* `poi_name` - Point of Interconnection name and voltage
* `service_type` - ERIS or NRIS designation
* `post_gia_status` - Generator Interconnection Agreement status
* `study_cycle` - Definitive Planning Phase cycle (e.g., "DPP-2018-APR")
* `study_group` - Study group assignment (Central, East, South, West)
* `study_phase` - Current study phase (DPP, GIA, etc.)
* `summer_mw` - Summer capacity rating
* `winter_mw` - Winter capacity rating
* `fuel_type` - Raw fuel type from MISO
* `facility_type` - Raw facility/technology type
* `dp1_eris_mw`, `dp1_nris_mw` - Decision Point 1 capacity breakdowns
* `dp2_eris_mw`, `dp2_nris_mw` - Decision Point 2 capacity breakdowns
* `county` - County name
* `state` - State code
### Raw Field Use Cases
**Changelog Integration**
```javascript theme={null}
// Join projects with changelog using MISO's project_id
const project = data.data[0];
const projectId = project.project_id; // "J1000"
// Use this to query changelog API
```
**Detailed Interconnection Analysis**
```javascript theme={null}
// Access transmission owner and POI details
const transmission = project.transmission_owner;
const poi = project.poi_name;
const voltage = poi.match(/(\d+)\s*kV/)[1]; // Extract voltage
```
**Study Status Tracking**
```javascript theme={null}
// Track project through MISO study process
const phase = project.study_phase;
const cycle = project.study_cycle;
const giaStatus = project.post_gia_status;
```
**Capacity Analysis**
```javascript theme={null}
// Analyze ERIS vs NRIS capacity allocations
const erisCapacity = project.dp2_eris_mw;
const nrisCapacity = project.dp2_nris_mw;
const serviceType = project.service_type;
```
**Data Updates**: MISO queue data is updated based on MISO's Generator Interconnection Queue reports.
**Wind Focus**: MISO territory has significant wind resources, particularly in the upper Midwest states. Wind projects typically have seasonal capacity variations reflected in the summer/winter capacity fields.
## OpenAPI
````yaml GET /interconnection/miso
openapi: 3.0.0
info:
title: Cleanview Public API
version: 0.1.0
description: >-
RESTful API for accessing clean energy data including EIA capacity and ISO
queue information
contact:
name: Cleanview Energy
url: https://cleanview.co/demo
servers:
- url: https://api.cleanview.co/api/v1
description: Production server
security:
- ApiKeyAuth: []
paths:
/interconnection/miso:
get:
tags:
- Interconnection
summary: Get MISO interconnection queue data
description: >-
Retrieve real-time interconnection queue data from Midcontinent
Independent System Operator (MISO)
parameters:
- in: query
name: limit
schema:
type: integer
minimum: 50
maximum: 5000
default: 50
description: Number of records to return
- in: query
name: offset
schema:
type: integer
default: 0
description: Number of records to skip
- in: query
name: state
schema:
type: string
description: Filter by state code
- in: query
name: technology
schema:
type: string
description: Filter by technology type
- in: query
name: min_capacity
schema:
type: number
description: Minimum capacity in MW
- in: query
name: max_capacity
schema:
type: number
description: Maximum capacity in MW
responses:
'200':
description: Successful response with MISO interconnection queue data
content:
application/json:
schema:
type: object
properties:
iso:
type: string
example: MISO
summary:
$ref: '#/components/schemas/Summary'
filters:
type: object
description: Applied filters for the request
data:
type: array
description: Array of interconnection queue records
items:
type: object
'401':
description: Unauthorized
'500':
description: Internal server error
security:
- ApiKeyAuth: []
components:
schemas:
Summary:
type: object
description: Summary metadata for pagination
properties:
limit:
type: integer
description: Number of records per page
offset:
type: integer
description: Number of records to skip
total_results:
type: integer
description: Total number of records matching the query
has_more:
type: boolean
description: Whether additional records exist beyond this page
current_page:
type: integer
description: Current page number (1-indexed)
total_pages:
type: integer
description: Total number of pages available
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key authentication using x-api-key header
````