---
title: "List Nodes"
method: GET
path: "/nodes/"
tags: ["Forecasts"]
---

# List Nodes

`GET /nodes/`

Returns the list of valid pricing nodes for a market region.

Use the `name` field to populate the `nodes` field in your `simulation_config` when creating a nodal forecast run via `POST /runs/`.

Requires `?region=` to select the market region and `?list_type=` to select the forecast or backtest node list. Supports `?search=` to filter nodes by name.

## Query parameters

- `region` 'caiso' | 'ercot' | 'gb' | 'germany' | 'isone' | 'italy' | 'miso' | 'nem' | 'nyiso' | 'pjm' | 'poland' | 'spain' | 'spp', required
- `list_type` 'forecast' | 'backtest', required
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of nodes.

- PaginatedNodeResponse
  - `count` integer — Total number of results.
  - `next` unknown
  - `previous` unknown
  - `results` Node[]
    - `name` string — Pricing node name. Use this value for the `nodes` field in your simulation_config when creating a nodal forecast run.
    - `voltage` number — Nominal voltage of the node in kV.
    - `zone` string — Load zone the node belongs to (e.g. Houston, North, South, West for ERCOT).

## Other responses

- `400` — Missing `region`, or missing or invalid `list_type`. Valid `list_type` values: forecast, backtest.
- `401` — Missing or invalid X-token.
- `404` — Unknown market region. Valid values: caiso, ercot, gb, germany, isone, italy, miso, nem, nyiso, pjm, poland, spain, spp.

---

[API](https://skmtc.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/revisions/6c4b83d3fc12/schema)