---
title: "List Constraint Binding Costs By Period"
method: GET
path: "/constraints/binding/costs"
tags: ["Constraints"]
---

# List Constraint Binding Costs By Period

`GET /constraints/binding/costs`

Summarize total binding cost per UTC period for a dataset.

## Query parameters

- `aggregation_period` 'hour' | 'day' | 'month' | 'year' — UTC aggregation period for grouping costs. Supported values: hour, day, month, year.
- `api_key` string, nullable — API key for authentication (query)
- `dataset_id` string, required
- `start_time` string, date-time, nullable — Filter to rows where time index >= start_time (ISO 8601)
- `end_time` string, date-time, nullable — Filter to rows where time index < end_time (ISO 8601 timestamp)
- `price_threshold` number, nullable — Optional threshold. When set, only include rows where ABS(configured shadow price column) > price_threshold.

## Headers

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

## Response `200`

Successful Response

- BindingConstraintCostResponse[]
  - `period_start_utc` string, date-time, required
  - `total_cost` number, nullable, required

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