---
title: "Get Constraint"
method: GET
path: "/constraints/{gs_entity_id}"
tags: ["Constraints"]
---

# Get Constraint

`GET /constraints/{gs_entity_id}`

Get data for a specific constraint by its GS entity ID.

## Path parameters

- `gs_entity_id` string, required — GS entity ID of the constraint to query

## Query parameters

- `api_key` string, nullable — API key for authentication (query)

## Headers

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

## Response `200`

Successful Response

- ConstraintResponse
  - `gs_entity_id` string, required
  - `constraint_name` string, required
  - `market_id` string, required
  - `earliest_seen_utc` string, date-time, nullable, required
  - `latest_seen_utc` string, date-time, nullable, required
  - `available_datasets` string[], nullable, required
  - `rt_cost` number, nullable
  - `da_cost` number, nullable
  - `gs_created_at_utc` string, date-time, nullable
  - `gs_updated_at_utc` string, date-time, 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)