---
title: "Search grid entities"
method: GET
path: "/api/v1/grid/search"
tags: ["Grid"]
---

# Search grid entities

`GET /api/v1/grid/search`

## Request

- Base URL: `https://askthegrid.com`
- URL: `https://askthegrid.com/api/v1/grid/search`
- Auth: HTTP bearer

Ranked search over plants, nodes, zones, substations and lines in one market. `limit` is clamped to 50 and defaults to 12.

## Query parameters

- `iso` union
  - ''
  - string
- `q` string
- `limit` union
  - number
  - string

## Response `200`

Success

- object
  - `hits` object[], required
    - `id` string, required
    - `label` string, required
    - `sublabel` string
    - `kind` 'zone' | 'plant' | 'load' | 'node' | 'substation' | 'line' | 'queue_project' | 'queue_county' | 'gis' | 'coordinate' | 'river_gauge', required
    - `haystack` string, required
    - `asset` union, required
      - object
        - `kind` 'plant', required
        - `id` string, required
        - `name` string, required
        - `fuel` 'nuclear' | 'coal' | 'natural gas' | 'wind' | 'solar' | 'hydroelectric' | 'batteries' | 'petroleum' | 'biomass' | 'other', required
        - `capacityMw` number, required
        - `zoneCode` string, required
        - `location` unknown[], required
          - unknown
        - `tech` string
        - `county` string
        - `nameplateMw` number
        - `marketNames` string[]
        - `settlementNodes` string[]
        - `lmp` number
        - `lmpNodeId` string
        - `publishedProfilePath` string
        - `sources` object[]
          - `provider` 'EIA' | 'HIFLD' | 'AESO' | 'NACEI' | 'OpenStreetMap' | 'California Energy Commission' | 'NRCan CanVec' | 'Nova Scotia Topographic Database', required
          - `sourceId` string, required
          - `href` string, required
        - `operator` string
        - `reference` string
        - `circuits` string
        - `cables` string
        - `supportCount` number
        - `towerCount` number
        - `poleCount` number
        - `portalCount` number
        - `underground` boolean
        - `frequency` string
        - `phases` string
        - `startDate` string
        - `geometrySource` string
        - `footprint` union
          - object
            - `type` 'Polygon', required
            - `coordinates` array[], required
              - …
          - object
            - `type` 'MultiPolygon', required
            - `coordinates` array[], required
              - …
        - `footprintAreaAcres` number
        - `footprintMethod` string
        - `assetClass` string
        - `geometryRole` string
        - `turbineCount` number
        - `turbineLocations` array[]
          - unknown[]
            - unknown
        - `equipmentCount` number
        - `equipmentByType` object
        - `equipmentVoltageLevelsKv` number[]
        - `interconnectionEquipmentCount` number
        - `interconnectionEquipmentByType` object
        - `manufacturers` string[]
        - `models` string[]
        - `interconnectionManufacturers` string[]
        - `interconnectionModels` string[]
        - `mappedName` string
        - `substationType` string
        - `voltageTag` string
        - `minVoltageKv` number
        - `voltageLevelsKv` number[]
        - `mappedVoltageLevelsKv` number[]
        - `resolutionState` string
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'zone', required
        - `code` string, required
        - `name` string, required
        - `aliases` string[], required
        - `blurb` string, required
        - `balancingAuthority` string
        - `regionType` string
        - `weim` boolean
        - `edam` boolean
        - `geometry` Schema0 (unresolved $ref)
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'gis', required
        - `layerId` string, required
        - `name` string, required
        - `layerLabel` string, required
        - `subtitle` string
        - `provider` string, required
        - `attribution` string, required
        - `color` string, required
        - `properties` object, required
        - `location` unknown[]
          - unknown
        - `geometry` Schema0 (unresolved $ref)
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'node', required
        - `id` string, required
        - `name` string, required
        - `settlementPoint` string
        - `location` unknown[]
          - unknown
        - `lmp` number, nullable, required
        - `ts` string, required
        - `nodeType` string
        - `derived` boolean
        - `controlArea` string
        - `siteKey` string
        - `siteSize` number
        - `role` string
        - `marketInterface` boolean
        - `interfaceKind` 'interface' | 'dc_tie'
        - `geometryMethod` 'published' | 'representative'
        - `source` string
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'substation', required
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `voltageKv` number
        - `city` string
        - `county` string
        - `subType` string
        - `status` string
        - `lines` number
        - `publishedProfilePath` string
        - `sources` object[]
          - `provider` 'EIA' | 'HIFLD' | 'AESO' | 'NACEI' | 'OpenStreetMap' | 'California Energy Commission' | 'NRCan CanVec' | 'Nova Scotia Topographic Database', required
          - `sourceId` string, required
          - `href` string, required
        - `operator` string
        - `reference` string
        - `circuits` string
        - `cables` string
        - `supportCount` number
        - `towerCount` number
        - `poleCount` number
        - `portalCount` number
        - `underground` boolean
        - `frequency` string
        - `phases` string
        - `startDate` string
        - `geometrySource` string
        - `footprint` union
          - object
            - `type` 'Polygon', required
            - `coordinates` array[], required
              - …
          - object
            - `type` 'MultiPolygon', required
            - `coordinates` array[], required
              - …
        - `footprintAreaAcres` number
        - `footprintMethod` string
        - `assetClass` string
        - `geometryRole` string
        - `turbineCount` number
        - `turbineLocations` array[]
          - unknown[]
            - unknown
        - `equipmentCount` number
        - `equipmentByType` object
        - `equipmentVoltageLevelsKv` number[]
        - `interconnectionEquipmentCount` number
        - `interconnectionEquipmentByType` object
        - `manufacturers` string[]
        - `models` string[]
        - `interconnectionManufacturers` string[]
        - `interconnectionModels` string[]
        - `mappedName` string
        - `substationType` string
        - `voltageTag` string
        - `minVoltageKv` number
        - `voltageLevelsKv` number[]
        - `mappedVoltageLevelsKv` number[]
        - `resolutionState` string
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'line', required
        - `id` string, required
        - `name` string, required
        - `voltageKv` number, required
        - `owner` string
        - `sub1` string
        - `sub2` string
        - `location` unknown[]
          - unknown
        - `geometry` union
          - object
            - `type` 'LineString', required
            - `coordinates` array[], required
              - …
          - object
            - `type` 'MultiLineString', required
            - `coordinates` array[], required
              - …
        - `publishedProfilePath` string
        - `sources` object[]
          - `provider` 'EIA' | 'HIFLD' | 'AESO' | 'NACEI' | 'OpenStreetMap' | 'California Energy Commission' | 'NRCan CanVec' | 'Nova Scotia Topographic Database', required
          - `sourceId` string, required
          - `href` string, required
        - `operator` string
        - `reference` string
        - `circuits` string
        - `cables` string
        - `supportCount` number
        - `towerCount` number
        - `poleCount` number
        - `portalCount` number
        - `underground` boolean
        - `frequency` string
        - `phases` string
        - `startDate` string
        - `geometrySource` string
        - `footprint` union
          - object
            - `type` 'Polygon', required
            - `coordinates` array[], required
              - …
          - object
            - `type` 'MultiPolygon', required
            - `coordinates` array[], required
              - …
        - `footprintAreaAcres` number
        - `footprintMethod` string
        - `assetClass` string
        - `geometryRole` string
        - `turbineCount` number
        - `turbineLocations` array[]
          - unknown[]
            - unknown
        - `equipmentCount` number
        - `equipmentByType` object
        - `equipmentVoltageLevelsKv` number[]
        - `interconnectionEquipmentCount` number
        - `interconnectionEquipmentByType` object
        - `manufacturers` string[]
        - `models` string[]
        - `interconnectionManufacturers` string[]
        - `interconnectionModels` string[]
        - `mappedName` string
        - `substationType` string
        - `voltageTag` string
        - `minVoltageKv` number
        - `voltageLevelsKv` number[]
        - `mappedVoltageLevelsKv` number[]
        - `resolutionState` string
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'load', required
        - `profileScope` 'US'
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `loadClass` 'data_center' | 'industrial' | 'other', required
        - `operator` string
        - `tenant` string
        - `status` string
        - `address` string
        - `city` string
        - `county` string
        - `purpose` string
        - `expectedOnline` string
        - `reportedDemandMw` number
        - `reportedDemandLowMw` number
        - `reportedDemandHighMw` number
        - `sizeRank` string
        - `powerSource` string
        - `dedicatedPowerPlant` string
        - `numberOfGenerators` string
        - `numberOfBuildings` string
        - `coolingSource` string
        - `coolingType` string
        - `facilitySizeSqft` number
        - `propertySizeAcres` number
        - `projectCost` string
        - `communityPushback` string
        - `advocacyInformation` string
        - `resistanceStatus` string
        - `publishedProfilePath` string
        - `sources` object[]
          - `provider` 'EIA' | 'HIFLD' | 'AESO' | 'NACEI' | 'OpenStreetMap' | 'California Energy Commission' | 'NRCan CanVec' | 'Nova Scotia Topographic Database', required
          - `sourceId` string, required
          - `href` string, required
        - `reference` string
        - `circuits` string
        - `cables` string
        - `supportCount` number
        - `towerCount` number
        - `poleCount` number
        - `portalCount` number
        - `underground` boolean
        - `frequency` string
        - `phases` string
        - `startDate` string
        - `geometrySource` string
        - `footprint` union
          - object
            - `type` 'Polygon', required
            - `coordinates` array[], required
              - …
          - object
            - `type` 'MultiPolygon', required
            - `coordinates` array[], required
              - …
        - `footprintAreaAcres` number
        - `footprintMethod` string
        - `assetClass` string
        - `geometryRole` string
        - `turbineCount` number
        - `turbineLocations` array[]
          - unknown[]
            - unknown
        - `equipmentCount` number
        - `equipmentByType` object
        - `equipmentVoltageLevelsKv` number[]
        - `interconnectionEquipmentCount` number
        - `interconnectionEquipmentByType` object
        - `manufacturers` string[]
        - `models` string[]
        - `interconnectionManufacturers` string[]
        - `interconnectionModels` string[]
        - `mappedName` string
        - `substationType` string
        - `voltageTag` string
        - `minVoltageKv` number
        - `voltageLevelsKv` number[]
        - `mappedVoltageLevelsKv` number[]
        - `resolutionState` string
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'outage_county', required
        - `id` string, required
        - `name` string, required
        - `stateFips` string, required
        - `metersOut` number, required
        - `outageCount` number, required
        - `utilities` object[], required
          - `name` string, required
          - `metersOut` number, nullable, required
        - `source` 'ODIN', required
        - `ts` string, required
        - `geometry` Schema0 (unresolved $ref)
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'queue_county', required
        - `id` string, required
        - `name` string, required
        - `countyFips` string, required
        - `location` unknown[], required
          - unknown
        - `geometry` Schema0, required (unresolved $ref)
        - `snapshotTime` string, nullable, required
        - `projectCount` number, required
        - `capacityMw` number, required
        - `activeProjectCount` number, required
        - `activeCapacityMw` number, required
        - `completedProjectCount` number, required
        - `completedCapacityMw` number, required
        - `withdrawnProjectCount` number, required
        - `withdrawnCapacityMw` number, required
        - `enteredProjectCount` number, required
        - `enteredCapacityMw` number, required
        - `exitedProjectCount` number, required
        - `exitedCapacityMw` number, required
        - `updatedProjectCount` number, required
        - `scheduledProjectCount` number, required
        - `scheduledCapacityMw` number, required
        - `overdueProjectCount` number, required
        - `overdueCapacityMw` number, required
        - `nextProposedCompletionDate` string, nullable, required
        - `deliveryProjectCountByYear` object, required
        - `deliveryCapacityMwByYear` object, required
        - `viewMode` 'current' | 'historical' | 'delivery', required
        - `requestedAt` string, nullable, required
        - `deliveryBy` string, nullable, required
        - `technologyCapacityMw` object, required
        - `topProjects` object[], required
          - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
          - `queueId` string, required
          - `projectName` string
          - `interconnectingEntity` string
          - `county` string
          - `state` string
          - `interconnectionLocation` string
          - `transmissionOwner` string
          - `generationType` string
          - `technology` 'battery' | 'solar' | 'wind' | 'gas' | 'nuclear' | 'hydro' | 'other', required
          - `capacityMw` number
          - `summerCapacityMw` number
          - `winterCapacityMw` number
          - `queueDate` string
          - `status` string
          - `proposedCompletionDate` string
          - `withdrawnDate` string
          - `withdrawalComment` string
          - `actualCompletionDate` string
          - `snapshotTime` string, required
          - `locationMatched` boolean
          - `locationMatchMethod` string
          - `locationLon` number
          - `locationLat` number
          - `locationEntityName` string
          - `locationEntityType` string
          - `countyFips` string
          - `location` unknown[]
            - unknown
          - `locationSource` 'matched' | 'county-centroid'
        - `marketSummaries` object[]
          - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
          - `snapshotTime` string, nullable, required
          - `projectCount` number, required
          - `capacityMw` number, required
          - `activeProjectCount` number, required
          - `activeCapacityMw` number, required
          - `completedProjectCount` number, required
          - `completedCapacityMw` number, required
          - `withdrawnProjectCount` number, required
          - `withdrawnCapacityMw` number, required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'queue_project', required
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `project` object, required
          - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
          - `queueId` string, required
          - `projectName` string
          - `interconnectingEntity` string
          - `county` string
          - `state` string
          - `interconnectionLocation` string
          - `transmissionOwner` string
          - `generationType` string
          - `technology` 'battery' | 'solar' | 'wind' | 'gas' | 'nuclear' | 'hydro' | 'other', required
          - `capacityMw` number
          - `summerCapacityMw` number
          - `winterCapacityMw` number
          - `queueDate` string
          - `status` string
          - `proposedCompletionDate` string
          - `withdrawnDate` string
          - `withdrawalComment` string
          - `actualCompletionDate` string
          - `snapshotTime` string, required
          - `locationMatched` boolean
          - `locationMatchMethod` string
          - `locationLon` number
          - `locationLat` number
          - `locationEntityName` string
          - `locationEntityType` string
          - `countyFips` string
          - `location` unknown[]
            - unknown
          - `locationSource` 'matched' | 'county-centroid'
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'river_gauge', required
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `state` string, nullable, required
        - `rfc` string, nullable, required
        - `ratedOn` 'stage' | 'flow', nullable, required
        - `stageFt` number, nullable, required
        - `flowCfs` number, nullable, required
        - `observedAt` string, nullable, required
        - `category` 'major' | 'moderate' | 'minor' | 'action' | 'no_flooding' | 'low_threshold' | 'not_defined' | 'obs_not_current' | 'fcst_not_current' | 'out_of_service' | 'unknown', required
        - `forecastStageFt` number, nullable, required
        - `forecastFlowCfs` number, nullable, required
        - `forecastAt` string, nullable, required
        - `forecastCategory` 'major' | 'moderate' | 'minor' | 'action' | 'no_flooding' | 'low_threshold' | 'not_defined' | 'obs_not_current' | 'fcst_not_current' | 'out_of_service' | 'unknown', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'distribution_substation', required
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `utility` unknown, required
        - `region` string, nullable, required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'utility', required
        - `id` unknown, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `ownership` string, nullable, required
        - `state` string, nullable, required
        - `balancingArea` string, nullable, required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'intertie', required
        - `schedulingPoint` boolean
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `neighbor` string, nullable, required
        - `controlled` boolean, required
        - `members` object[], required
          - `publisherIso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
          - `id` string, required
          - `name` string, required
          - `flowKind` 'free' | 'controlled' | 'scheduled', required
          - `neighbor` string, nullable, required
          - `flowMw` number, nullable, required
          - `scheduledMw` number, nullable, required
          - `positiveLimitMw` number, nullable, required
          - `negativeLimitMw` number, nullable, required
          - `loadingPct` number, nullable, required
          - `positiveHeadroomMw` number, nullable, required
          - `negativeHeadroomMw` number, nullable, required
          - `headroomMw` number, nullable, required
          - `sign` 'export_positive' | 'import_positive', nullable, required
          - `asOf` string, nullable, required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'pin', required
        - `id` string, required
        - `name` string, required
        - `location` unknown[], required
          - unknown
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
      - object
        - `kind` 'event', required
        - `id` string, required
        - `name` string, required
        - `eventIds` string[], required
        - `location` unknown[]
          - unknown
        - `geometry` Schema0 (unresolved $ref)
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
    - `command` union, required
      - object
        - `op` 'focusZone', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `zone` string, required
        - `highlight` boolean
      - object
        - `op` 'highlightZones', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `zones` string[], required
      - object
        - `op` 'showPlants', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `zoneCode` string
        - `fuel` string
        - `plantIds` string[]
      - object
        - `op` 'focusPlant', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `plantId` string, required
      - object
        - `op` 'focusPoint', required
        - `lng` number, required
        - `lat` number, required
      - object
        - `op` 'focusNode', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `nodeId` string, required
        - `nodeName` string
        - `location` unknown[]
          - unknown
      - object
        - `op` 'selectAssets', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `plantIds` string[]
        - `zoneCodes` string[]
        - `fit` boolean
      - object
        - `op` 'setLayers', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
        - `show` string[]
        - `hide` string[]
        - `exclusive` boolean
      - object
        - `op` 'setAttention', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO', required
        - `enabled` boolean, required
        - `nodeId` string
        - `nodeName` string
        - `direction` 'attends' | 'attended'
        - `component` 'correction' | 'foundation'
        - `band` 'all' | 'near' | 'middle' | 'far'
      - object
        - `op` 'reset', required
        - `iso` 'ERCOT' | 'NYISO' | 'CAISO' | 'PJM' | 'MISO' | 'ISONE' | 'SPP' | 'BPAT' | 'TVA' | 'DUK' | 'CPLE' | 'CPLW' | 'FPC' | 'FPL' | 'SOCO' | 'BCA' | 'AESO' | 'IESO' | 'CENACE' | 'HQ' | 'BCH' | 'MHEB' | 'SPC' | 'NBSO' | 'NSIESO'
    - `standalonePagePath` string, nullable, required
    - `publicAssetPath` string, nullable, required

## Other responses

- `400`: The request did not match the contract.
- `401`: Missing or invalid credentials.
- `429`: Rate limit exceeded. Wait `Retry-After` seconds; `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` report the budget. Signed-in sessions and API keys have larger budgets than anonymous callers.

---

[API](https://skmtc.dev/askthegrid/apis/ask-the-grid-api.md) · [All operations](https://skmtc.dev/askthegrid/apis/ask-the-grid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/askthegrid/apis/ask-the-grid-api/revisions/9cd80115e395?raw)