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

# SPP Interconnection Queue

> Access real-time Southwest Power Pool interconnection queue data for all power projects

## Overview

The SPP interconnection queue endpoint provides access to real-time data from Southwest Power Pool's interconnection queue. SPP serves the central United States with significant wind resources.

<Note>
  **SPP Coverage**: Contains **800+ projects** across the central U.S. Top technologies: Wind (400+ projects), Solar (200+ projects), Battery Storage (100+ projects), Natural Gas (100+ projects).
</Note>

## Endpoint

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

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

## Coverage Area

**States Served**: Arkansas, Kansas, Louisiana, Missouri, Nebraska, New Mexico, Oklahoma, and Texas, with portions of Iowa, Minnesota, Montana, North Dakota, South Dakota, and Wyoming.

## 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`        | 400+  | Wind turbine projects (dominant in SPP territory) |
| `Solar`       | 200+  | Solar photovoltaic projects                       |
| `Battery`     | 100+  | Battery energy storage systems                    |
| `Natural Gas` | 100+  | Natural gas generation                            |
| `Other`       | 50+   | Other technologies                                |

### Status Options

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

### Top States by Project Count

| State      | Project Count | Top Technology |
| ---------- | ------------- | -------------- |
| Oklahoma   | 340           | Wind, Solar    |
| Kansas     | 199           | Wind           |
| Nebraska   | 129           | Wind           |
| Texas      | 106           | Wind, Solar    |
| New Mexico | 75            | Solar, Wind    |

## Example Requests

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

  <Accordion title="Get Large Solar Projects (>100 MW)">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/spp?technology=Solar&min_capacity=100&limit=50"
    ```
  </Accordion>

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

    Filters for projects developed by NextEra Energy Resources. Uses partial matching to find all NextEra projects in SPP territory.
  </Accordion>
</AccordionGroup>

## Response Schema

<ResponseExample>
  ```json Example Response theme={null}
  {
    "iso": "SPP",
    "summary": {
      "limit": 50,
      "offset": 0,
      "total_results": 2806,
      "has_more": true,
      "current_page": 1,
      "total_pages": 57
    },
    "filters": {
      "state": null,
      "technology": null,
      "status": null,
      "min_capacity": null,
      "max_capacity": null,
      "developer": null
    },
    "data": [
      {
        "iso": "SWPP",
        "queue_id": "GEN-2011-019",
        "project_name": "Woodward County",
        "capacity_mw": 175,
        "technology": "Wind",
        "fuel": null,
        "status": "Planned",
        "detailed_status": "IA FULLY EXECUTED/ON SCHEDULE",
        "operating_date": "2027-12-31",
        "request_date": "3/31/2011",
        "county": "Woodward County",
        "state": "OK",
        "queue_position": null,
        "interconnecting_entity": null,
        "developer": null,
        "balancing_authority_code": "SWPP",
        "technology_normalized": "Wind",
        "generation_interconnection_number": "GEN-2011-019",
        "ifs_queue_number": null,
        "current_cluster": "DISIS-2011-001-8",
        "cluster_group": "04 SOUTHEAST",
        "nearest_town_or_county": "Woodward County",
        "to_at_poi": "OGE",
        "in_service_date": "2012-12-31",
        "commercial_operation_date": "2027-12-31",
        "cessation_date": null,
        "original_generator_commercial_op_date": null,
        "capacity": 175,
        "max_summer_mw": 175,
        "max_winter_mw": 175,
        "service_type": "ER/NR",
        "requested_maximum_injection_capability_mw": 0,
        "requested_network_resource_deliverability_mw": 0,
        "nameplate_capacity": 0,
        "generation_type": "Wind",
        "fuel_type": null,
        "substation_or_line": "Woodward EHV 345kV",
        "request_received": "3/31/2011",
        "date_withdrawn": null,
        "jtiq_participant": null,
        "jtiq_commitment": null,
        "cause_of_delay": null,
        "status_detailed": "IA FULLY EXECUTED/ON SCHEDULE"
      }
    ]
  }
  ```
</ResponseExample>

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

## Response Fields

### Core Identification Fields

| Field                               | Type   | Description                                                  |
| ----------------------------------- | ------ | ------------------------------------------------------------ |
| `iso`                               | string | Always "SWPP" for SPP data                                   |
| `queue_id`                          | string | Unique SPP queue identifier (e.g., "GEN-2011-019")           |
| `generation_interconnection_number` | string | Official SPP Generation Interconnection Request number       |
| `ifs_queue_number`                  | string | SPP Integrated Facilities Study queue number (if applicable) |
| `project_name`                      | string | Official project name in SPP queue                           |
| `balancing_authority_code`          | string | Always "SWPP"                                                |
| `queue_position`                    | string | Queue position number (typically null in SPP data)           |

### Capacity & Technology

| Field                                          | Type   | Description                                              |
| ---------------------------------------------- | ------ | -------------------------------------------------------- |
| `capacity_mw`                                  | number | Project nameplate capacity in MW                         |
| `capacity`                                     | number | Duplicate of capacity\_mw for compatibility              |
| `max_summer_mw`                                | number | Maximum summer capacity rating in MW                     |
| `max_winter_mw`                                | number | Maximum winter capacity rating in MW                     |
| `nameplate_capacity`                           | number | Generator nameplate capacity in MW                       |
| `requested_maximum_injection_capability_mw`    | number | Requested maximum MW injection to grid                   |
| `requested_network_resource_deliverability_mw` | number | Requested network resource deliverability capacity in MW |
| `technology`                                   | string | SPP's technology classification (e.g., "Wind", "Solar")  |
| `generation_type`                              | string | Detailed generation type from SPP source                 |
| `technology_normalized`                        | string | Standardized technology for cross-ISO filtering          |
| `fuel`                                         | string | Primary fuel source code                                 |
| `fuel_type`                                    | string | Detailed fuel type description with hybrid notation      |

### Project Status & Dates

| Field                                   | Type   | Description                                                   |
| --------------------------------------- | ------ | ------------------------------------------------------------- |
| `status`                                | string | Standardized status (Planned, Operating, Cancelled, Inactive) |
| `detailed_status`                       | string | Original SPP detailed status code                             |
| `status_detailed`                       | string | Duplicate of detailed\_status for compatibility               |
| `request_date`                          | string | Interconnection request submission date                       |
| `request_received`                      | string | Date SPP received interconnection request                     |
| `in_service_date`                       | string | Originally scheduled in-service date                          |
| `operating_date`                        | string | Expected or actual commercial operation date                  |
| `commercial_operation_date`             | string | Actual commercial operation date when achieved                |
| `original_generator_commercial_op_date` | string | Original projected commercial operation date                  |
| `date_withdrawn`                        | string | Date project was withdrawn from queue (if applicable)         |
| `cessation_date`                        | string | Date project operations ceased (if applicable)                |

### Location

| Field                    | Type   | Description                                                     |
| ------------------------ | ------ | --------------------------------------------------------------- |
| `state`                  | string | State code (OK, KS, NE, TX, NM, MO, ND, AR, SD, LA, MT, IA, MN) |
| `county`                 | string | County name where project is located                            |
| `nearest_town_or_county` | string | Nearest town or county from SPP source                          |

### Study Process & Cluster Information

| Field             | Type   | Description                                                      |
| ----------------- | ------ | ---------------------------------------------------------------- |
| `current_cluster` | string | Current DISIS cluster assignment (e.g., "DISIS-2011-001-8")      |
| `cluster_group`   | string | SPP transmission zone for cluster studies (e.g., "04 SOUTHEAST") |
| `cause_of_delay`  | string | Reason for study process delays (if applicable)                  |

### Grid Connection & Service

| Field                    | Type   | Description                                                  |
| ------------------------ | ------ | ------------------------------------------------------------ |
| `service_type`           | string | Interconnection service type (ER, NR, or ER/NR)              |
| `to_at_poi`              | string | Transmission Owner at Point of Interconnection               |
| `substation_or_line`     | string | Specific substation or transmission line for interconnection |
| `interconnecting_entity` | string | Interconnecting utility entity (typically null)              |

### SPP-Specific Fields

| Field              | Type   | Description                                                    |
| ------------------ | ------ | -------------------------------------------------------------- |
| `jtiq_participant` | string | Joint Targeted Interconnection Queue participant (Yes/No/null) |
| `jtiq_commitment`  | number | JTIQ financial commitment amount (if applicable)               |

### Developer Information

| Field       | Type   | Description                                                 |
| ----------- | ------ | ----------------------------------------------------------- |
| `developer` | string | Developer name from Cleanview enrichment (limited coverage) |

## SPP Queue Terminology

### DISIS (Definitive Interconnection System Impact Study)

SPP's cluster study process where projects are studied in annual cohorts grouped by transmission zone. Projects are studied together to assess cumulative system impacts and allocate network upgrade costs equitably among projects in each cluster.

### Cluster Groups

SPP divides its territory into transmission zones (e.g., "04 SOUTHEAST", "03 CENTRAL") for organizing DISIS cluster studies. Each annual DISIS cohort (e.g., "DISIS-2011-001") contains projects grouped by these zones for efficient regional analysis.

### Service Types

* **ER (Energy Resource)**: Energy-only interconnection without transmission network upgrade obligations
* **NR (Network Resource)**: Full network service requiring participation in network upgrade costs and providing firm transmission capacity
* **ER/NR**: Hybrid service combining both energy resource and network resource interconnection rights

### JTIQ (Joint Targeted Interconnection Queue)

Coordinated interconnection study process for projects located at the SPP/MISO seam requiring joint analysis by both ISOs to assess impacts on both systems.

### Generation Interconnection Agreement (GIA)

Final contract between generator and SPP governing interconnection terms, cost allocation, operational requirements, and construction milestones.

### Status Categories

SPP tracks detailed project status through multiple study phases:

* **IA FULLY EXECUTED/ON SCHEDULE**: Interconnection Agreement signed and project on schedule
* **IA FULLY EXECUTED/COMMERCIAL OPERATION**: Project has achieved commercial operation
* **IA FULLY EXECUTED/ON SUSPENSION**: Agreement executed but study process suspended
* **IA PENDING**: Interconnection Agreement pending execution
* **DISIS STAGE**: In Definitive Interconnection System Impact Study phase
* **FACILITY STUDY STAGE**: In Facilities Study phase evaluating specific interconnection facilities
* **FEASIBILITY**: In Feasibility Study phase
* **ERAS**: In Early Risk Assessment Study phase (optional pre-study)
* **WITHDRAWN**: Project withdrawn from queue by developer
* **TERMINATED**: Project terminated by SPP

<Note>
  **Data Updates**: SPP queue data is updated based on Southwest Power Pool's Generation Interconnection queue reports.
</Note>


## OpenAPI

````yaml GET /interconnection/spp
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/spp:
    get:
      tags:
        - Interconnection
      summary: Get SPP interconnection queue data
      description: >-
        Retrieve real-time interconnection queue data from Southwest Power Pool
        (SPP)
      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 SPP interconnection queue data
          content:
            application/json:
              schema:
                type: object
                properties:
                  iso:
                    type: string
                    example: SPP
                  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

````