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

# PJM Interconnection Queue

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

## Overview

The PJM interconnection queue endpoint provides access to real-time data from PJM Interconnection's generation interconnection queue. PJM serves 13 states and the District of Columbia in the Mid-Atlantic and Midwest regions.

<Note>
  **PJM Coverage**: Contains **9,200+ projects** across 13 states. Top technologies: Solar (4,000+ projects), Natural Gas (1,100+ projects), Storage (1,000+ projects), Wind (700+ projects).
</Note>

## Endpoint

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

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

## Coverage Area

**States Served**: Delaware, Illinois, Indiana, Kentucky, Maryland, Michigan, New Jersey, North Carolina, Ohio, Pennsylvania, Tennessee, Virginia, West Virginia, and Washington D.C.

## 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 (PA, OH, NJ, etc.) - supports comma-separated                          |
| `technology`   | string  | -       | Filter by standardized technology type (derived from fuel\_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

<Tip>
  Use standardized technology names. See our [Interconnection Reference](/api-reference/interconnection-codes#technology-classifications) for all available options.
</Tip>

| Technology       | Count  | Description                         |
| ---------------- | ------ | ----------------------------------- |
| `Solar`          | 4,000+ | Solar photovoltaic projects         |
| `Natural Gas`    | 1,100+ | Natural gas generation              |
| `Storage`        | 1,000+ | Battery energy storage systems      |
| `Wind`           | 700+   | Wind turbine projects               |
| `Solar; Storage` | 500+   | Combined solar and storage projects |
| `Methane`        | 190+   | Methane/biogas projects             |
| `Coal`           | 140+   | Coal generation                     |
| `Hydro`          | 95+    | Hydroelectric projects              |
| `Offshore Wind`  | 80+    | Offshore wind projects              |
| `Nuclear`        | 78+    | Nuclear generation                  |
| `Other`          | 300+   | Other technologies                  |

<Note>
  **Technology Mapping**: The `technology` field is standardized from PJM's original `fuel_type` data to provide consistent filtering across all CleanView APIs.
</Note>

### Status Options

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

### Top States by Project Count

| State        | Project Count | Top Technology     |
| ------------ | ------------- | ------------------ |
| Pennsylvania | \~400         | Solar, Natural Gas |
| Ohio         | \~300         | Solar, Wind        |
| New Jersey   | \~250         | Solar              |
| Illinois     | \~200         | Solar, Wind        |
| Virginia     | \~180         | Solar              |

## Example Requests

<AccordionGroup>
  <Accordion title="Get Active Solar Projects in Pennsylvania">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/pjm?technology=Solar&status=Planned&state=PA&limit=50"
    ```

    Returns active solar projects in Pennsylvania within the PJM territory.
  </Accordion>

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

    Finds large-scale natural gas projects in the PJM queue.
  </Accordion>

  <Accordion title="Get Projects by Multiple States">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/pjm?state=PA,OH,NJ&limit=50"
    ```

    Uses comma-separated values for multi-state filtering in the Mid-Atlantic region.
  </Accordion>

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

    Filters projects that have developer mapping data. Supports partial matching (e.g., "Invenergy" matches "Invenergy LLC"). Projects without developer data are excluded from filtered results.
  </Accordion>
</AccordionGroup>

## Response Schema

<ResponseExample>
  ```json Example Response theme={null}
  {
    "iso": "PJM",
    "summary": {
      "limit": 50,
      "offset": 0,
      "total_results": 1834,
      "has_more": true,
      "current_page": 1,
      "total_pages": 37
    },
    "filters": {
      "state": null,
      "technology": null,
      "status": null,
      "min_capacity": null,
      "max_capacity": null,
      "developer": null
    },
    "data": [
      {
        "iso": "PJM",
        "queue_id": "1003606",
        "project_name": "FE-PJM",
        "capacity_mw": 200.0,
        "technology": "Solar",
        "fuel": "Solar",
        "status": "Planned",
        "detailed_status": "Active",
        "operating_date": "2025-12-01T00:00:00.000Z",
        "request_date": "2022-03-15T00:00:00.000Z",
        "county": "Chester",
        "state": "PA",
        "queue_position": null,
        "interconnecting_entity": null,
        "developer": "Lightsource BP",
        "feasibility_study_status": "Complete",
        "system_impact_study_status": "In Progress",
        "facilities_study_status": "Not Started",
        "interconnection_agreement_status": null,
        "construction_service_agreement_status": null,
        "transmission_owner": "PECO",
        "project_type": "Generation Interconnection",
        "balancing_authority_code": "PJM",
        "technology_normalized": "Solar",
        "project_number": "1003606",
        "commercial_name": "Keystone Solar",
        "maximum_facility_output": 200
      },
      {
        "iso": "PJM",
        "queue_id": "V1-026",
        "project_name": "Limerick",
        "capacity_mw": 150.0,
        "technology": "Wind",
        "fuel": "Wind",
        "status": "Operating",
        "detailed_status": "In Service",
        "operating_date": "2024-06-15T00:00:00.000Z",
        "request_date": "2021-08-20T00:00:00.000Z",
        "county": "Huron",
        "state": "OH",
        "queue_position": null,
        "interconnecting_entity": null,
        "developer": "EDF Renewables",
        "feasibility_study_status": "Complete",
        "system_impact_study_status": "Complete",
        "facilities_study_status": "Complete",
        "interconnection_agreement_status": "Executed",
        "construction_service_agreement_status": "Executed",
        "transmission_owner": "AEP",
        "project_type": "Generation Interconnection",
        "balancing_authority_code": "PJM",
        "technology_normalized": "Wind",
        "project_number": "V1-026",
        "commercial_name": "Buckeye Wind",
        "maximum_facility_output": 150
      }
    ]
  }
  ```
</ResponseExample>

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

## Response Fields

### Core Fields (Always Present)

| Field                      | Type   | Description                                                                 |
| -------------------------- | ------ | --------------------------------------------------------------------------- |
| `iso`                      | string | Always "PJM" for PJM data                                                   |
| `queue_id`                 | string | Unique PJM project number (e.g., "1003606" or "V1-026")                     |
| `project_name`             | string | Project name (usually available)                                            |
| `capacity_mw`              | number | Project capacity in MW                                                      |
| `technology`               | string | Standardized technology type                                                |
| `status`                   | string | Standardized status (Planned, Operating, Cancelled)                         |
| `queue_position`           | string | Queue position identifier (null - PJM does not provide queue position data) |
| `balancing_authority_code` | string | Always "PJM"                                                                |

### Location & Timing

| Field            | Type   | Description                               |
| ---------------- | ------ | ----------------------------------------- |
| `state`          | string | State code (PA, OH, NJ, etc.)             |
| `county`         | string | County name where project is located      |
| `operating_date` | date   | Expected/actual commercial operation date |
| `request_date`   | date   | Date project entered queue                |

### Technology & Fuel

| Field                   | Type   | Description                                            |
| ----------------------- | ------ | ------------------------------------------------------ |
| `fuel`                  | string | Original fuel type from PJM data                       |
| `technology`            | string | Standardized technology type (derived from fuel\_type) |
| `technology_normalized` | string | Same as `technology` for consistency                   |

### PJM-Specific Fields

| Field                | Type   | Description                                             |
| -------------------- | ------ | ------------------------------------------------------- |
| `transmission_owner` | string | Transmission utility (PECO, PPL, etc.)                  |
| `project_type`       | string | Interconnection type (Generation Interconnection, etc.) |

### Study Process

| Field                              | Type   | Description                                |
| ---------------------------------- | ------ | ------------------------------------------ |
| `feasibility_study_status`         | string | Feasibility study completion status        |
| `system_impact_study_status`       | string | System impact study status                 |
| `facilities_study_status`          | string | Facilities study completion status         |
| `interconnection_agreement_status` | string | Interconnection agreement execution status |

### Developer Information

| Field                    | Type   | Description                                                                 |
| ------------------------ | ------ | --------------------------------------------------------------------------- |
| `interconnecting_entity` | string | Always null - PJM queue does not provide interconnecting entity information |
| `developer`              | string | Developer name (limited availability)                                       |

<Note>
  **Data Updates**: PJM queue data is updated monthly based on PJM's New Services Queue reports. The API reflects the most recent interconnection queue data available.
</Note>

<Info>
  **Study Process**: PJM uses a detailed multi-phase study process including feasibility, system impact, and facilities studies. The study status fields track progress through each phase.
</Info>

<Warning>
  **Missing Coordinates**: PJM data does not include latitude/longitude coordinates. Use the `county`, `state`, and `transmission_owner` fields for geographic analysis.
</Warning>


## OpenAPI

````yaml GET /interconnection/pjm
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/pjm:
    get:
      tags:
        - Interconnection
      summary: Get PJM interconnection queue data
      description: Retrieve real-time interconnection queue data from PJM Interconnection
      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
          example: PA
        - in: query
          name: technology
          schema:
            type: string
          description: Filter by technology type
          example: Solar
        - 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 PJM interconnection queue data
          content:
            application/json:
              schema:
                type: object
                properties:
                  iso:
                    type: string
                    example: PJM
                  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

````