---
title: "Get Structure By Id"
method: GET
path: "/v1/structures/{structure_id}"
tags: ["structures"]
---

# Get Structure By Id

`GET /v1/structures/{structure_id}`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/structures/{structure_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

This endpoint retrieves a structure by its ID. The ID should be provided as a path parameter in the URL.

If a structure with the provided ID does not exist, the endpoint returns a 404 error.

## Path parameters

- `structure_id` string, required

## Response `200`

Successful Response

- StructureView
  - `id` integer, required
  - `uuid` string, uuid4, required
  - `name` string, required
  - `projectId` string, nullable
  - `createdBy` string, required
  - `createdAt` string, date-time, required
  - `designStandardKey` 'EN_01' | 'MSZ_EN_01' | 'NS_EN_01' | 'DIN_EN_01' | 'NF_EN_01' | 'SFS_EN_01' | 'SS_EN_01' | 'BS_EN_01' | 'IS_EN_01' | 'BDS_EN_01' | 'UNI_EN_01' | 'TIA_222_I' | 'TIA_222_H' | 'TIA_222_G' | 'TIA_222_F' | 'PN_EN_01' | 'ASNZS_01', required
  - `sections` string[], nullable, required
  - `tripodParameters` TripodParametersView, required
    - `poleHeightM` number, required
    - `poleDiameterMM` number, required
    - `poleThicknessMM` number, required
    - `diagonalOffsetM` number, required
    - `diagonalAttachmentHeightM` number, required
    - `diagonalDiameterMM` number, required
    - `diagonalThicknessMM` number, required
    - `steelMaterial` string, required
  - `productId` string, nullable, required
  - `sourceMountDesignUuid` string, nullable
  - `mountDesignName` string, nullable
  - `capacityStatus` 'UNKNOWN' | 'OVERLOADED' | 'UNDERLOADED', required
  - `isStaleAnalysis` boolean, required
  - `isInvalidatedAnalysis` boolean
  - `maxUtilizationPercent` number, nullable
  - `productType` 'tower' | 'guyed_mast' | 'monopole' | 'rooftop' | 'hybrid' | 'mount' | 'unknown', required
  - `tags` StructureTagView[], required
    - `value` string, required
    - `color` string, required
  - `organizationId` integer, required
  - `analysisRunId` string, uuid4, nullable
  - `draftCount` integer
  - `versionSeq` integer
  - `role` 'live' | 'draft' | 'snapshot'

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/shapemaker/apis/shapemaker-api.md) - [All operations](https://skmtc.dev/shapemaker/apis/shapemaker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shapemaker/apis/shapemaker-api/revisions/b8461cf1236c?raw)