---
title: "Server-side set-reduction over the ISO interconnection queue"
method: GET
path: "/api/v1/interconnection-queue/refined"
tags: ["Public"]
---

# Server-side set-reduction over the ISO interconnection queue

`GET /api/v1/interconnection-queue/refined`

## Request

- Base URL: `https://dchub.cloud`
- URL: `https://dchub.cloud/api/v1/interconnection-queue/refined`
- Auth: none declared

Filters US interconnection-queue projects server-side so an agent ingests survivors, not the raw queue (avoids in-context-filter token blowup). Predicates: min_mw, max_ttp_months (ISO-level estimate), iso (comma union), baseload_only, fuel_type, and the Phase-2 spatial predicates max_fiber_km + geocoded_only. Returns the DCHubEnvelope with _entity=queue_results; ~83% of survivors carry lat/lng + a compact per-survivor site_evaluation_handoff (ready-to-pipe analyze_site + get_water_risk args).

## Query parameters

- `min_mw` number
- `max_ttp_months` integer
- `iso` string
- `baseload_only` boolean
- `fuel_type` string
- `status` string
- `max_fiber_km` number
- `geocoded_only` boolean
- `limit` integer

## Response `200`

Refined queue survivors (_entity=queue_results)

- DCHubEnvelope: Universal response envelope for every DC Hub tool and endpoint. The STABLE anchor an agent branches on before parsing the entity payload: full-data, gated-preview and error responses all share it. `_entity` is the type discriminator; the entity-specific payload is passthrough (additionalProperties). Branch on `_entity` + `ok`.
  - `_entity` 'facility' | 'market' | 'grid' | 'fiber' | 'gas' | 'deal' | 'site' | 'news' | 'energy' | 'incentives' | 'risk' | 'index' | 'pipeline' | 'infrastructure' | 'export' | 'changes' | 'alert' | 'meta' | 'semantic_search' | 'error' | 'record', required: Payload type discriminator — branch on this before parsing.
  - `ok` boolean: Success flag; false + _entity='error' on failure.
  - `_source` string
  - `_cite` string: Attribution string (CC-BY-4.0).
  - `citation` object
    - `source` string
    - `url` string
    - `license` string
    - `cite_as` string
  - `next_session` object: Context-aware next-step hints — the agent's state-machine menu for what to call next.

---

[API](https://skmtc.dev/dchub/apis/dc-hub-data-center-intelligence-api.md) · [All operations](https://skmtc.dev/dchub/apis/dc-hub-data-center-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dchub/apis/dc-hub-data-center-intelligence-api/revisions/15f74d15cdeb?raw)