> ## 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.

# NYISO Interconnection Queue

> Access real-time NYISO interconnection queue data for all power projects

## Overview

The NYISO interconnection queue endpoint provides access to real-time data from the New York Independent System Operator (NYISO) interconnection queue. NYISO serves all of New York State.

<Note>
  **NYISO Coverage**: Contains **400+ projects** across New York State. Top technologies: Solar (150+ projects), Wind (100+ projects), Battery Storage (80+ projects), Natural Gas (70+ projects).
</Note>

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: your_api_key_here" \
    "https://api.cleanview.co/api/v1/interconnection/nyiso?limit=50"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.cleanview.co/api/v1/interconnection/nyiso?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/nyiso?limit=50',
      headers=headers
  )
  data = response.json()
  ```
</CodeGroup>

## Coverage Area

**State Served**: New York (entire state)

## 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 (NY) - 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                                  |
| ------------- | ----- | -------------------------------------------- |
| `Solar`       | 150+  | Solar photovoltaic projects                  |
| `Wind`        | 100+  | Wind turbine projects (onshore and offshore) |
| `Battery`     | 80+   | Battery energy storage systems               |
| `Natural Gas` | 70+   | Natural gas generation                       |
| `Other`       | 50+   | Other technologies                           |

### Status Options

| Status      | Description                   |
| ----------- | ----------------------------- |
| `Planned`   | Active projects in queue      |
| `Operating` | Commercial operation achieved |
| `Cancelled` | Withdrawn or terminated       |

### NYISO Load Zones

| Zone | Description   | Primary Technologies            |
| ---- | ------------- | ------------------------------- |
| A    | Western NY    | Wind, Natural Gas               |
| B    | Genesee       | Wind, Solar                     |
| C    | Central NY    | Wind, Solar                     |
| D    | North NY      | Wind, Hydro                     |
| E    | Mohawk Valley | Solar, Natural Gas              |
| F    | Capital       | Solar, Wind                     |
| G    | Hudson Valley | Solar, Storage                  |
| H    | Millwood      | Solar, Storage                  |
| I    | Dunwoodie     | Solar, Storage                  |
| J    | NYC           | Solar, Storage, Natural Gas     |
| K    | Long Island   | Solar, Storage, Wind (offshore) |

## Example Requests

<AccordionGroup>
  <Accordion title="Get Solar Projects in New York">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/nyiso?technology=Solar&state=NY&limit=50"
    ```
  </Accordion>

  <Accordion title="Get Offshore Wind Projects">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/nyiso?technology=Wind&min_capacity=400&limit=50"
    ```
  </Accordion>

  <Accordion title="Get Ørsted Projects">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/nyiso?developer=Orsted&limit=50"
    ```

    Filters for projects developed by Ørsted (offshore wind). Uses partial matching to find all Ørsted projects.
    Note: Ørsted is stored as Orsted in the database.
  </Accordion>
</AccordionGroup>

## Response Schema

<ResponseExample>
  ```json Example Response theme={null}
  {
    "success": true,
    "iso": "NYISO",
    "summary": {
      "limit": 50,
      "offset": 0,
      "total_results": 2151,
      "has_more": true,
      "current_page": 1,
      "total_pages": 44
    },
    "filters": {
      "state": null,
      "technology": null,
      "status": null,
      "min_capacity": null,
      "max_capacity": null,
      "developer": null
    },
    "data": [
      {
        "iso": "NYIS",
        "queue_id": "0495_mohawk_solar",
        "project_name": "Mohawk Solar",
        "capacity_mw": 90.5,
        "technology": "S",
        "fuel": "S",
        "status": "Planned",
        "detailed_status": "IA Completed",
        "operating_date": "2027-11-01T07:00:00.000Z",
        "request_date": "2015-04-02T07:00:00.000Z",
        "county": "Montgomery",
        "state": "NY",
        "queue_position": "0495",
        "developer_interconnection_customer": "Mohawk Solar LLC",
        "developer": "AES Clean Energy",
        "zone": "F",
        "utility": "NM-NG",
        "balancing_authority_code": "NYIS",
        "technology_normalized": "Solar",
        "project_id": "0495_mohawk_solar",
        "queue_pos": "0495",
        "date_of_ir": "2015-04-02T07:00:00.000Z",
        "capacity_mw_summer": 90.5,
        "capacity_mw_winter": 90.5,
        "type_fuel": "S",
        "energy_storage_capability": null,
        "minimum_duration_full_discharge": null,
        "points_of_interconnection": "St. Johnsville - Marshville 115kV",
        "affected_transmission_owner_ato": null,
        "status_detailed": "IA Completed",
        "last_updated_date": "2022-09-30T07:00:00.000Z",
        "availability_of_studies": "FES, SRIS, FS",
        "ia_tender_date": "2021-02-08T08:00:00.000Z",
        "cy_fs_complete_date": "2021-02-08T08:00:00.000Z",
        "proposed_in_service_initial_backfeed_date": "2027-06-01T07:00:00.000Z",
        "proposed_sync_date": "2027-10-01T07:00:00.000Z",
        "proposed_cod": "2027-11-01T07:00:00.000Z",
        "withdrawal_date": null
      },
      {
        "iso": "NYIS",
        "queue_id": "0522_nyc_energy",
        "project_name": "NYC Energy",
        "capacity_mw": 79.9,
        "technology": "ES",
        "fuel": "ES",
        "status": "Planned",
        "detailed_status": "Accepted Cost Allocation/IA in Progress",
        "operating_date": "2027-06-01T07:00:00.000Z",
        "request_date": "2015-12-16T08:00:00.000Z",
        "county": "Kings",
        "state": "NY",
        "queue_position": "0522",
        "developer_interconnection_customer": "NYC Energy LLC",
        "developer": "NYC Energy",
        "zone": "J",
        "utility": "ConEd",
        "balancing_authority_code": "NYIS",
        "technology_normalized": "Battery",
        "project_id": "0522_nyc_energy",
        "queue_pos": "0522",
        "date_of_ir": "2015-12-16T08:00:00.000Z",
        "capacity_mw_summer": 79.9,
        "capacity_mw_winter": 79.9,
        "type_fuel": "ES",
        "energy_storage_capability": null,
        "minimum_duration_full_discharge": "4.0",
        "points_of_interconnection": "Hudson Avenue East 138kV",
        "affected_transmission_owner_ato": null,
        "status_detailed": "Accepted Cost Allocation/IA in Progress",
        "last_updated_date": "2025-01-31T08:00:00.000Z",
        "availability_of_studies": "FES, SRIS, FS",
        "ia_tender_date": null,
        "cy_fs_complete_date": "2024-12-16T08:00:00.000Z",
        "proposed_in_service_initial_backfeed_date": "2027-05-01T07:00:00.000Z",
        "proposed_sync_date": "2027-05-01T07:00:00.000Z",
        "proposed_cod": "2027-06-01T07:00:00.000Z",
        "withdrawal_date": null
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  **Complete Upstream Data**: Each project includes all 38 database columns from NYISO's interconnection queue at the top level. This provides complete transparency with both standardized fields (normalized across all ISOs) and NYISO-specific raw fields like `queue_pos`, `energy_storage_capability`, and `minimum_duration_full_discharge`.
</Note>

## Response Fields

### Core Identification

| Field                      | Type   | Description                                                   |
| -------------------------- | ------ | ------------------------------------------------------------- |
| `iso`                      | string | Always "NYIS" for NYISO data                                  |
| `queue_id`                 | string | Unique NYISO queue identifier (e.g., "0495\_mohawk\_solar")   |
| `project_id`               | string | NYISO project identifier (same as queue\_id)                  |
| `project_name`             | string | Official project name in NYISO queue                          |
| `queue_position`           | string | Numeric queue position (e.g., "0495", "0522")                 |
| `queue_pos`                | string | NYISO original queue position field (same as queue\_position) |
| `balancing_authority_code` | string | Always "NYIS"                                                 |

### Capacity & Technology

| Field                   | Type   | Description                                                     |
| ----------------------- | ------ | --------------------------------------------------------------- |
| `capacity_mw`           | number | Project nameplate capacity in MW (uses summer rating)           |
| `capacity_mw_summer`    | number | Summer-rated capacity in MW                                     |
| `capacity_mw_winter`    | number | Winter-rated capacity in MW                                     |
| `technology`            | string | NYISO technology code (e.g., "S"=Solar, "ES"=Storage, "NG"=Gas) |
| `type_fuel`             | string | NYISO original fuel/technology type field (same as technology)  |
| `fuel`                  | string | Fuel or energy source (same as technology for NYISO)            |
| `technology_normalized` | string | Standardized technology for cross-ISO filtering                 |

### Energy Storage Fields

| Field                             | Type   | Description                                            |
| --------------------------------- | ------ | ------------------------------------------------------ |
| `energy_storage_capability`       | string | Energy storage capability designation (typically null) |
| `minimum_duration_full_discharge` | string | Storage duration in hours at full discharge rate       |

### Project Status & Dates

| Field                                       | Type   | Description                                                          |
| ------------------------------------------- | ------ | -------------------------------------------------------------------- |
| `status`                                    | string | Standardized status (Planned, Operating, Cancelled)                  |
| `status_detailed`                           | string | Original NYISO status (e.g., "IA Completed", "SRIS/SIS in Progress") |
| `detailed_status`                           | string | NYISO detailed status (same as status\_detailed)                     |
| `request_date`                              | date   | Interconnection request submission date                              |
| `date_of_ir`                                | date   | Date of interconnection request (same as request\_date)              |
| `operating_date`                            | date   | Proposed commercial operation date                                   |
| `proposed_cod`                              | date   | Proposed commercial operation date (same as operating\_date)         |
| `proposed_in_service_initial_backfeed_date` | date   | Proposed initial backfeed/energization date                          |
| `proposed_sync_date`                        | date   | Proposed synchronization date                                        |
| `withdrawal_date`                           | date   | Date project was withdrawn (if applicable)                           |
| `last_updated_date`                         | date   | Last update date in NYISO queue                                      |

### Location

| Field    | Type   | Description                          |
| -------- | ------ | ------------------------------------ |
| `state`  | string | Always "NY" for New York             |
| `county` | string | County name where project is located |
| `zone`   | string | NYISO load zone (A through K)        |

### Study Process & Interconnection

| Field                     | Type   | Description                                 |
| ------------------------- | ------ | ------------------------------------------- |
| `availability_of_studies` | string | Completed studies (e.g., "FES, SRIS, FS")   |
| `cy_fs_complete_date`     | date   | Class Year Facilities Study completion date |
| `ia_tender_date`          | date   | Interconnection Agreement tender date       |

### Grid Connection

| Field                             | Type   | Description                                            |
| --------------------------------- | ------ | ------------------------------------------------------ |
| `points_of_interconnection`       | string | Point of interconnection description and voltage level |
| `utility`                         | string | Transmission Owner (TO) utility                        |
| `affected_transmission_owner_ato` | string | Affected Transmission Owner (typically null)           |

### Developer Information

| Field                                | Type   | Description                                  |
| ------------------------------------ | ------ | -------------------------------------------- |
| `developer`                          | string | Developer name from Cleanview enrichment     |
| `developer_interconnection_customer` | string | Original NYISO interconnection customer name |

<Note>
  **Data Updates**: NYISO queue data is updated based on NYISO's interconnection queue reports.
</Note>

<Warning>
  **Field Availability**: Some fields like `energy_storage_capability` and `affected_transmission_owner_ato` are typically null in NYISO data. The `minimum_duration_full_discharge` field is only populated for battery storage projects.
</Warning>

## NYISO Queue Terminology

### Load Zones (A-K)

NYISO divides New York State into 11 geographic load zones that reflect transmission constraints and local electricity market conditions. Each zone represents a specific region with distinct pricing and capacity characteristics.

| Zone | Description   | Primary Technologies            |
| ---- | ------------- | ------------------------------- |
| A    | Western NY    | Wind, Natural Gas               |
| B    | Genesee       | Wind, Solar                     |
| C    | Central NY    | Wind, Solar                     |
| D    | North NY      | Wind, Hydro                     |
| E    | Mohawk Valley | Solar, Natural Gas              |
| F    | Capital       | Solar, Wind                     |
| G    | Hudson Valley | Solar, Storage                  |
| H    | Millwood      | Solar, Storage                  |
| I    | Dunwoodie     | Solar, Storage                  |
| J    | NYC           | Solar, Storage, Natural Gas     |
| K    | Long Island   | Solar, Storage, Wind (offshore) |

### Study Process Phases

NYISO projects progress through a multi-phase study process to assess technical feasibility and interconnection costs.

**FES (Feasibility Study)**: Initial technical and cost assessment to identify major system impacts and preliminary cost estimates.

**SRIS (System Reliability Impact Study)**: Detailed reliability analysis to determine required network upgrades for system reliability. This is the standard study path for most projects.

**SIS (System Impact Study)**: Alternative streamlined study path available for smaller projects with minimal system impact.

**FS (Facilities Study)**: Final engineering and cost estimates for required interconnection facilities and network upgrades.

### Queue Positions

Projects are assigned numeric queue positions (e.g., "0495", "0522", "1721") when their interconnection request application is accepted as complete by NYISO. Lower numbers indicate earlier queue entry.

### Status Types

**Planned**: Active projects progressing through studies or awaiting construction. Includes statuses like "SRIS/SIS in Progress", "IA Completed", and "Accepted Cost Allocation".

**Operating**: Projects that have achieved commercial operation, marked as "In Service Commercial" in NYISO data.

**Cancelled**: Projects withdrawn from the queue, with withdrawal dates tracked for historical reference.

### Technology Codes

NYISO uses single-letter or two-letter codes for technology types: "S" (Solar), "ES" (Energy Storage), "NG" (Natural Gas), "W" (Wind), "F" (Flywheel), "DC" (DC Transmission), "AC" (AC Transmission), "L" (Load/Data Center).

### Storage Duration

For battery storage projects, the `minimum_duration_full_discharge` field indicates how many hours the system can discharge at full rated capacity. Common values are "2.0", "4.0", or "8.0" hours.


## OpenAPI

````yaml GET /interconnection/nyiso
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/nyiso:
    get:
      tags:
        - Interconnection
      summary: Get NYISO interconnection queue data
      description: >-
        Retrieve real-time interconnection queue data from New York Independent
        System Operator (NYISO)
      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 (NY)
          example: NY
        - 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 NYISO interconnection queue data
          content:
            application/json:
              schema:
                type: object
                properties:
                  iso:
                    type: string
                    example: NYISO
                  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

````