---
title: "List Binding Constraints With Locations"
method: GET
path: "/constraints/binding/locations"
tags: ["Constraints"]
---

# List Binding Constraints With Locations

`GET /constraints/binding/locations`

Get unique binding constraints for a dataset/time window with locations.

Scans binding observations for ``dataset_id`` in ``[start_time, end_time)``,
collapses peak-|shadow| per (constraint, interval), keeps the top
``limit`` constraints by peak |shadow|, joins facility coordinates and
contingency identity/names, and returns one object per constraint with
nested observations, ordered by that ranking.

## Query parameters

- `limit` integer — Maximum number of unique binding constraints to return (all intervals for each are included).
- `api_key` string, nullable — API key for authentication (query)
- `dataset_id` string, required
- `start_time` string, date-time, required — Filter to rows where time index >= start_time (ISO 8601)
- `end_time` string, date-time, required — Filter to rows where time index < end_time (ISO 8601 timestamp)

## Headers

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

## Response `200`

Successful Response

- BindingConstraintsWithLocationsResponse — Binding constraints for a dataset/time window, merged with substations.
  - `constraints` BindingConstraintWithLocationResponse[], required
    - `constraint_gs_entity_id` string, required
    - `constraint_name` string, required
    - `start` SubstationLocation — Lat/lon and display name for a substation.
      - `latitude` number, required
      - `longitude` number, required
      - `name` string, required
    - `end` SubstationLocation — Lat/lon and display name for a substation.
      - `latitude` number, required
      - `longitude` number, required
      - `name` string, required
    - `observations` BindingConstraintObservation[], required
      - `interval_start_utc` string, date-time, required
      - `shadow_price` number, nullable
      - `contingency_gs_entity_id` string, nullable
      - `contingency_name` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gridstatus/apis/grid-status-api.md) · [All operations](https://skmtc.dev/gridstatus/apis/grid-status-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gridstatus/grid-status-api/revisions/43e6e1047e53/schema)