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

# Get Constraint Location

`GET /constraints/{constraint_id}/location`

Retrieve start/end substation coordinates for a constraint.

Returns nullable ``start`` and ``end`` lat/lon from the market's constraint
geometry table. Markets without a geometry table return 400. Unknown constraint
ids return 404.

## Path parameters

- `constraint_id` string, required — GS entity ID of the constraint to get facility location for

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

- ConstraintLocationResponse — Start/end substation coordinates for a constraint. Either endpoint may be null when that constraint has no mapped coords. Markets without a geometry table are rejected by the endpoint (400).
  - `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

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-24** `43e6e1047e53` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gridstatus/apis/grid-status-api/changes/constraints/:constraint_id/location/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)