---
title: "Get Block Pricing"
method: GET
path: "/block-pricing/{iso}"
tags: ["Block Pricing Data"]
---

# Get Block Pricing

`GET /block-pricing/{iso}`

Returns block-averaged prices for an ISO over the requested date range.

The response is a list of columns. Daily columns (keyed by ISO date) cover the requested range, and additional summary columns are appended: `MTD` (month-to-date) and a `Month-Year` label for each full month spanned. Each column's `value` is the volume-weighted average price for the block over that window.

Each datum includes `pct_change`, the percent change of `value` relative to the previous period for the same market and block (prior market day for daily columns; prior calendar month for summary columns). It is null when the previous period has no value or when the prior value is zero.

The `complete` flag indicates whether every interval in the window has reported data; it is `false` for in-progress windows such as the current day or month-to-date.

## Path parameters

- `iso` 'CAISO' | 'ERCOT' | 'IESO' | 'ISONE' | 'MISO' | 'NYISO' | 'PJM' | 'SPP', required

## Query parameters

- `params` BlockPricingQueryParams, required
  - `start_date` string, date, required — Start of date range (inclusive), interpreted in the ISO market timezone.
  - `end_date` string, date, required — End of date range (exclusive), interpreted in the ISO market timezone.
  - `location` string, required — Location filter.
  - `market` string, nullable — Optional market filter. Allowed values: "da" or "rt".
  - `blocks` string, nullable — Optional comma-separated list of block values. Allowed values: 7x24, 7x8, 2x16h, on-peak, off-peak.
- `api_key` string, nullable — API key for authentication (query)

## Headers

- `x-api-key` string, nullable — API key for authentication (header)

## Response `200`

Successful response

- BlockPricingDateGroup[]
  - `date` string, required — Column identifier: an ISO date (YYYY-MM-DD) for a daily column, "MTD" for month-to-date, or a "Month-Year" label for a full-month summary.
  - `is_nerc_holiday` boolean — Whether the daily column is a NERC holiday. False for summary columns.
  - `data` BlockPricingDatum[], required — Block values for this column, one entry per market/block.
    - `market` string, required — Market the value is for ("da" or "rt").
    - `block` string, required — Block the value is for (e.g. 7x24, on-peak, off-peak).
    - `value` number, nullable, required — Volume-weighted average price for the block over the column's window, or null when no data is available.
    - `pct_change` number, nullable, required — Percent change of `value` relative to the previous period for the same market and block (e.g. the prior market day for daily columns, or the prior calendar month for summary columns). Null when the previous period has no value or when the prior value is zero.
    - `complete` boolean, required — Whether every interval in the column's window has reported data. False for in-progress windows (e.g. the current day or month-to-date).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/gridstatus/apis/grid-status-api.md) · [All operations](https://skmtc.net/gridstatus/apis/grid-status-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gridstatus/grid-status-api/versions/fa1f094be2d4/schema)