---
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 absolute_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
  - `absolute_cost` number, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-20** `de58449b43e2` — 1 warning, 1 info
  - removed the optional property `items/total_cost` from the response with the `200` status
  - added the optional property `items/absolute_cost` to the response with the `200` status

[Change history](https://skmtc.dev/gridstatus/apis/grid-status-api/changes/constraints/:constraint_id/contingencies/get.md)

---

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