Public

Server-side set-reduction over the ISO interconnection queue

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

get/api/v1/interconnection-queue/refined

Request

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

Query parameters

min_mwnumber

Minimum project capacity in MW (e.g. 1000 for 1 GW+)

max_ttp_monthsinteger

Max time-to-power in months (ISO-level avg interconnection wait; keeps projects in ISOs at or under this)

isostring

Restrict to one or more ISOs (comma-separated union), from PJM/ERCOT/MISO/CAISO/SPP/NYISO/ISO-NE. e.g. iso=ERCOT,PJM. Hyphens are normalized (ISONE == ISO-NE). Combines with max_ttp_months as an intersection.

baseload_onlyboolean

Keep only firm/dispatchable fuel; exclude wind/solar/storage. (Firm/intermittent split only — does NOT sub-divide peaker vs combined-cycle gas; the queue has no duty-cycle field.)

fuel_typestring

Inclusive substring match on the raw fuel label; comma/semicolon separated for a union (e.g. 'gas' hits GAS/Natural Gas, 'nuclear,hydro' unions both). Use to isolate a specific generation class server-side instead of post-filtering in context.

statusstring

Queue status filter. Default 'active' = still progressing (excludes withdrawn/cancelled/suspended/in-commercial-operation) — cross-ISO safe, since SPP labels live projects 'IA FULLY EXECUTED/ON SCHEDULE' etc. rather than 'active'. 'all' = no filter; any other value = literal substring match.

max_fiber_kmnumber

Keep only survivors within this many km of the nearest MAPPED long-haul fiber route endpoint (coarse backbone proximity from a sparse ~260-node dataset, over a county-centroid origin — NOT last-mile fiber distance). Implies geocoded rows only.

geocoded_onlyboolean

Keep only survivors that carry lat/lng (~83% of the queue) — i.e. those an agent can pipe straight into analyze_site via the site_evaluation_handoff.

limitinteger

Max survivors returned

Response

Refined queue survivors (_entity=queue_results)

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

okboolean

Success flag; false + _entity='error' on failure.

_sourcestring
_citestring

Attribution string (CC-BY-4.0).

next_sessionobject

Context-aware next-step hints — the agent's state-machine menu for what to call next.

Example response

{
  "_source": "DC Hub — dchub.cloud"
}

Changes

No recorded changes to this operation across all 1 revision of this API.