Skip to main content

Interconnection Queue API Overview

The Cleanview API provides access to interconnection queue data from 7 major grid operators across the United States. Our API is designed with a focus on reliability and simplicity, offering the most valuable parameters for data analysis and pipeline applications.

Available Grid Operators

Supported Parameters

All interconnection endpoints support a streamlined set of parameters designed for data pipeline and analysis use cases:

Core Filtering Parameters

  • state - Filter by state code (e.g., CA, TX, NY) - supports comma-separated values
  • technology - Filter by technology type (e.g., Solar, Wind, Battery) - supports comma-separated values
  • status - Filter by project status (Operating, Planned, Cancelled, etc.)
  • min_capacity - Minimum capacity in MW (numeric)
  • max_capacity - Maximum capacity in MW (numeric)

Pagination Parameters

  • limit - Number of records per page (50-5000, default: 1000)
  • offset - Number of records to skip (default: 0)

Parameter Validation

Our API uses strict parameter validation following industry best practices:
  • Supported parameters are processed and applied as filters
  • Unknown parameters are rejected with a 400 Bad Request error
  • 🛡️ Invalid values are rejected with clear error messages
This approach prevents “silent failures” where invalid parameters might be ignored, ensuring your queries work exactly as intended.

Basic Usage Examples

Response Structure

All endpoints return consistent response structures:

Common Use Cases

Market Analysis

  • Track renewable development by region and technology
  • Analyze capacity trends and market penetration
  • Identify growth opportunities by state

Site Selection

  • Find development patterns in target regions
  • Compare technology deployment across states
  • Analyze competitive landscape

Portfolio Management

  • Monitor project status changes across multiple ISOs
  • Track development pipelines
  • Benchmark against market trends

Data Integration

  • Export data for analysis in BI tools
  • Build automated reporting pipelines
  • Create custom dashboards and visualizations

Error Handling

The API returns clear, actionable error messages:
Common error scenarios:
  • 400 Bad Request - Invalid or unknown parameters
  • 401 Unauthorized - Missing or invalid API key
  • 429 Too Many Requests - Rate limit exceeded
  • 500 Internal Server Error - Server-side issues

Next Steps

  1. Get Started: Request your API key from our team
  2. Explore Endpoints: Review individual ISO endpoint documentation
  3. Test Integration: Use our interactive API documentation
  4. Build Applications: Integrate with your data pipeline or application
For detailed parameter documentation and examples, see the individual endpoint pages for each ISO.