---
title: "List Contingencies For Constraint"
method: GET
path: "/constraints/{constraint_id}/contingencies"
tags: ["Constraints"]
---

# List Contingencies For Constraint

`GET /constraints/{constraint_id}/contingencies`

Contingencies binding for a constraint in a dataset/time window.

## Path parameters

- `constraint_id` string, required — Constraint GS entity ID to filter by (constraint_gs_entity_id)

## Query parameters

- `dataset_id` string, required
- `include_binding_stats` boolean — When true, include binding_intervals and total_cost and apply start_time/end_time/time filters. Default returns id and name only.
- `start_time` string, nullable — Start time (ISO timestamp) for filtering (inclusive). Requires time index column. Only used when include_binding_stats is true.
- `end_time` string, nullable — End time (ISO timestamp) for filtering (exclusive). Requires time index column. Only used when include_binding_stats is true.
- `time` string, nullable — Optional specific timestamp to filter results. Cannot be used with start_time or end_time. Only used when include_binding_stats is true.
- `api_key` string, nullable — API key for authentication (query)

## Headers

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

## Response `200`

Successful Response

- ContingencyResponse[]
  - `id` string, nullable, required
  - `name` string, required
  - `binding_intervals` integer, nullable
  - `total_cost` number, nullable

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