{
  "anchors": [
    {
      "about": "2-letter state/jurisdiction code (PD-003).",
      "format": "usps_state",
      "kind": "geography",
      "name": "state",
      "scope": "universal"
    },
    {
      "about": "5-digit Census county FIPS, zero-padded string.",
      "format": "fips5",
      "kind": "geography",
      "name": "county_fips",
      "scope": "universal"
    }
  ],
  "capability": "power.interconnection_queue",
  "codebooks": {
    "application_status": {
      "codes": {
        "Active": {
          "label": "Active \u2014 a live request still in the queue (requested, not built)"
        },
        "Done": {
          "label": "Done \u2014 completed / in service"
        },
        "LEGACY: Done": {
          "label": "Legacy completed (pre-current-system)"
        },
        "Pending Revision Approval": {
          "label": "Pending revision approval"
        },
        "Pending Transfer": {
          "label": "Pending transfer"
        },
        "Withdrawn": {
          "label": "Withdrawn \u2014 the request left the queue (the queue is withdrawn-dominated)"
        }
      },
      "coverage": "the distinct status values observed in the served MISO snapshot",
      "note": "ALWAYS scope by `application_status` \u2014 the full queue is dominated by Withdrawn requests. `Active` is the live pipeline of REQUESTED (not built) capacity; `Withdrawn` requests have left the queue; `Done` are completed / in service. A queue-MW total is requested capacity, never built \u2014 for built/operating capacity use query_power_capacity_v1.",
      "semantics": "as_reported_queue_status",
      "source": "MISO getprojects `applicationStatus` \u2014 the as-reported application status."
    },
    "fuel_type": {
      "codes": {
        "Battery Storage": {
          "label": "Battery storage"
        },
        "Biomass": {
          "label": "Biomass"
        },
        "Coal": {
          "label": "Coal"
        },
        "Combined Cycle": {
          "label": "Natural gas combined cycle"
        },
        "Compressed Air Storage": {
          "label": "Compressed-air energy storage"
        },
        "Diesel": {
          "label": "Diesel"
        },
        "Gas": {
          "label": "Natural gas"
        },
        "High Voltage DC": {
          "label": "High-voltage DC (transmission)"
        },
        "Hybrid": {
          "label": "Hybrid (multi-technology \u2014 see facility_type for the components)"
        },
        "Hydro": {
          "label": "Hydro"
        },
        "Nuclear": {
          "label": "Nuclear"
        },
        "Solar": {
          "label": "Solar"
        },
        "Waste Heat Recovery": {
          "label": "Waste heat recovery"
        },
        "Wind": {
          "label": "Wind"
        }
      },
      "coverage": "the distinct fuel values observed in the served MISO snapshot",
      "note": "Filter `fuel_type` by MISO's EXACT value shown here \u2014 e.g. `Gas` for natural gas (NOT 'Natural Gas'). `Hybrid` is MISO's multi-technology catch-all; the slash-joined components (e.g. 'Solar/Battery') live in `facility_type`. Values are as-reported, so an early-stage request with no fuel is null, not a category.",
      "semantics": "as_reported_fuel_taxonomy",
      "source": "MISO getprojects `fuelType` \u2014 the queue's own as-reported fuel taxonomy."
    }
  },
  "data_point": {
    "does_not_answer": [
      "built, installed, operating, or nameplate capacity (that is power.capacity / EIA-860M; queue MW is REQUESTED, not built)",
      "a sum of requested MW treated as planned or operating capacity (most queued MW withdraws \u2014 requested totals are labeled, never read as built)",
      "a cross-ISO or national queue total (methodologies, inclusion, and withdrawal rates differ per ISO \u2014 never summed or deduped across ISOs)",
      "which projects are data-center- or load-driven (MISO reports no load/data-center type; that inference is the analyst's, never tagged here)",
      "the probability that a queued project will actually be built or reach commercial operation",
      "generation MWh, demand, prices, retail sales, or transmission",
      "lat/lon or plant-level attribution (MISO supplies none; only state, as-reported county, and derived county_fips)",
      "queues for other ISOs/RTOs (PJM, CAISO, NYISO, ISO-NE, ERCOT, SPP) \u2014 each is a separate block under the same gate"
    ],
    "grain": "project_snapshot",
    "id": "power.interconnection_queue",
    "note": "This is MISO's generator interconnection queue \u2014 REQUESTED capacity (a waiting line), NOT built / installed / operating capacity. Historically the large majority of queued MW withdraws before it is built, so a requested-MW total is additive across projects but must never be read as built capacity. Every atom carries its as-reported status (application_status / study_phase / post_gia_status) so active, withdrawn, and done requests can be told apart; for operating capacity use query_power_capacity_v1. MISO only \u2014 never summed or compared across ISOs; for the PJM queue use query_power_interconnection_queue_pjm_v1, for CAISO query_power_interconnection_queue_caiso_v1.",
    "product_spec": "blocks/power_interconnection_queue/card.md",
    "represented_fact": "The MISO generator interconnection queue (GI Queue) \u2014 the public waiting line of every project that has REQUESTED to connect to the MISO grid, served as-reported, project by project, with its requested megawatts and its three as-reported status dimensions (applicationStatus / studyPhase / postGIAStatus). This is a REQUEST, not built, committed, or planned capacity: historically the large majority of queued MW withdraws before it is built, so every MW field is named requested_* and is never summed as operating capacity. This is the only forward-looking slice in the power surface (capacity/generation/demand are backward-looking actuals). MISO carries no county_fips and no lat/lon; county_fips is derived by name where it resolves and left null otherwise. It is NOT a data-center product \u2014 MISO reports no load/data-center type and we never infer one.",
    "source_basis": [
      "energy.miso.giqueue"
    ],
    "source_decisions": [
      "docs/verticals/power/interconnection-queues.md"
    ]
  },
  "input": {
    "controls": [
      "include_records",
      "include_evidence",
      "limit",
      "order_by",
      "top_n",
      "order",
      "rollup_other"
    ],
    "date_range_params": [
      "queue_date_from",
      "queue_date_to"
    ],
    "date_ranges": [
      "queue_date"
    ],
    "field_metadata": {},
    "filters": [
      "as_of",
      "state",
      "county_fips",
      "application_status",
      "study_phase",
      "post_gia_status",
      "fuel_type",
      "facility_type",
      "service_type",
      "study_group",
      "study_cycle",
      "is_hybrid"
    ],
    "group_by": [
      "state",
      "county_fips",
      "application_status",
      "study_phase",
      "post_gia_status",
      "fuel_type",
      "facility_type",
      "service_type",
      "study_group",
      "study_cycle",
      "is_hybrid"
    ],
    "ranking": {
      "no_ranking": "Omit order_by and top_n to return all groups in group-key order.",
      "order": {
        "default": "desc",
        "valid_values": [
          "desc",
          "asc"
        ]
      },
      "order_by": {
        "accepts": "one of output.metrics",
        "note": "Ranks the groups by a metric (a measure). Not a group_by dimension \u2014 rows already come back grouped by each group_by field.",
        "requires": [
          "group_by"
        ],
        "valid_values": [
          "requested_summer_mw",
          "requested_winter_mw",
          "source_record_count"
        ]
      },
      "top_n": {
        "note": "Keeps the top N groups by order_by; the rest fold into one (other) remainder (additive metrics sum into it, non-additive ones are nulled) so the result still reconciles to summary.totals.",
        "requires": [
          "group_by",
          "order_by"
        ],
        "type": "positive integer"
      }
    }
  },
  "output": {
    "aggregate_citation_fields": [
      "source_id",
      "publisher",
      "source_url",
      "source_file",
      "raw_file_sha256",
      "as_of",
      "source_rows_count",
      "source_rows_sample",
      "verify",
      "lineage_filter"
    ],
    "citation_fields": [
      "source_id",
      "source_url",
      "source_file",
      "sheet",
      "source_row",
      "raw_file_sha256",
      "as_of"
    ],
    "detail_fields": [
      "source_id",
      "sheet_name",
      "iso",
      "project_id",
      "miso_internal_id",
      "transmission_owner",
      "poi_name",
      "state",
      "state_raw",
      "county",
      "county_fips",
      "county_fips_source",
      "county_fips_unresolved",
      "service_type",
      "fuel_type",
      "facility_type",
      "is_hybrid",
      "requested_summer_mw",
      "requested_winter_mw",
      "requested_dp1_eris_mw",
      "requested_dp1_nris_mw",
      "requested_dp2_eris_mw",
      "requested_dp2_nris_mw",
      "application_status",
      "study_phase",
      "post_gia_status",
      "study_group",
      "study_cycle",
      "queue_date",
      "withdrawn_date",
      "in_service_date",
      "done_date",
      "gia_to_exec_date",
      "neg_in_service_date",
      "report_period",
      "source_record_key",
      "source_row_number",
      "as_of",
      "raw_file_sha256",
      "citation"
    ],
    "metric_groups": {
      "records": [
        "source_record_count"
      ],
      "requested_mw": [
        "requested_summer_mw",
        "requested_winter_mw"
      ]
    },
    "metric_metadata": {
      "requested_summer_mw": {
        "additive_across_groups": true,
        "aggregation": "sum",
        "authoritative_total_path": "summary.totals.requested_summer_mw",
        "category": "requested_mw",
        "definition": "The project's requested net summer interconnection capacity (MW), as MISO reports it on the queue.",
        "description": "REQUESTED interconnection capacity (MW) \u2014 what a project asked to connect, NOT built, installed, or operating capacity. Historically the large majority of queued MW withdraws before it is built, so a requested-MW total is meaningful only as a REQUESTED total: it is additive across distinct projects (each is its own request) but must never be read as built capacity. Filter application_status (Active / Withdrawn / Done) to scope the queue; for operating capacity use query_power_capacity_v1.",
        "display_name": "Requested capacity (net summer)",
        "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.",
        "grain": "queue project",
        "null_handling": "A project with no reported summer MW contributes null (ignored by the sum); an empty-query summary returns zero.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.requested_summer_mw",
        "source_fields": [
          "requested_summer_mw"
        ],
        "unit": "MW"
      },
      "requested_winter_mw": {
        "additive_across_groups": true,
        "aggregation": "sum",
        "authoritative_total_path": "summary.totals.requested_winter_mw",
        "category": "requested_mw",
        "definition": "The project's requested net winter interconnection capacity (MW), as MISO reports it on the queue.",
        "description": "REQUESTED interconnection capacity (MW) \u2014 what a project asked to connect, NOT built, installed, or operating capacity. Historically the large majority of queued MW withdraws before it is built, so a requested-MW total is meaningful only as a REQUESTED total: it is additive across distinct projects (each is its own request) but must never be read as built capacity. Filter application_status (Active / Withdrawn / Done) to scope the queue; for operating capacity use query_power_capacity_v1.",
        "display_name": "Requested capacity (net winter)",
        "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.",
        "grain": "queue project",
        "null_handling": "A project with no reported winter MW contributes null (ignored by the sum); an empty-query summary returns zero.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.requested_winter_mw",
        "source_fields": [
          "requested_winter_mw"
        ],
        "unit": "MW"
      },
      "source_record_count": {
        "additive_across_groups": true,
        "aggregation": "count source records",
        "authoritative_total_path": "summary.totals.source_record_count",
        "category": "records",
        "definition": "Count of queued projects in the current result scope (one atom = one MISO project).",
        "description": "Number of queued projects (MISO getprojects records) contributing to the value \u2014 scope with application_status to separate active from withdrawn.",
        "display_name": "Queued project count",
        "display_precision": "Integer.",
        "grain": "queue project",
        "null_handling": "Always an integer count.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.source_record_count",
        "source_fields": [
          "source_record_key"
        ],
        "unit": "count"
      }
    },
    "metrics": [
      "requested_summer_mw",
      "requested_winter_mw",
      "source_record_count"
    ],
    "summary_fields": [
      "group_count",
      "totals"
    ]
  },
  "primitive": "query_power_interconnection_queue_v1",
  "status": "available"
}