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

# List Constraint Binding Counts By Period

`GET /constraints/binding/counts`

Summarize unique binding constraints per UTC period for a dataset.

## Query parameters

- `aggregation_period` 'hour' | 'day' | 'month' | 'year' — UTC aggregation period for grouping counts. 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

- BindingConstraintCountResponse[]
  - `period_start_utc` string, date-time, required
  - `binding_constraint_count` integer, required
  - `binding_constraint_ids` string[], 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)