---
title: "Analyze Structure"
method: POST
path: "/v1/structures/{structure_id}/analyze"
tags: ["analysis"]
---

# Analyze Structure

`POST /v1/structures/{structure_id}/analyze`

## 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}/analyze`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

## Path parameters

- `structure_id` string, required

## Response `200`

Successful Response

- AnalyzeView
  - `analysisRunId` string, required
  - `summary` StructureResultSummaryView, required
    - `createdAtUTC` string, date-time, required
    - `status` 'UNKNOWN' | 'OVERLOADED' | 'UNDERLOADED', required
    - `isStale` boolean, required
    - `legsPercent` number, required
    - `legsIsOk` boolean, required
    - `bracingMembersPercent` number, required
    - `bracingMembersIsOk` boolean, required
    - `jointsPercent` number, required
    - `jointsIsOk` boolean, required
    - `foundationPercent` number, nullable
    - `foundationIsOk` boolean, nullable
    - `anchorsPercent` number, nullable
    - `anchorsIsOk` boolean, nullable
    - `naturalFrequencyHz` number, nullable, required
    - `naturalFrequencyIsOk` boolean, nullable, required
    - `deformation` number, nullable, required
    - `deformationIsOk` boolean, nullable, required
    - `restCapacity` number, required
    - `restCapacityIsOk` boolean, required
    - `restCapacityGoverningPart` string, 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
    - `guyFoundationsPercent` number, nullable, required
    - `guyFoundationsIsOk` boolean, nullable, required
    - `guyWiresPercent` number, nullable, required
    - `guyWiresIsOk` boolean, nullable, required
    - `monopoleHoldDownBoltsPercent` number, nullable, required
    - `monopoleHoldDownBoltsIsOk` boolean, nullable, required
    - `monopoleMembersPercent` number, nullable, required
    - `monopoleMembersIsOk` boolean, nullable, required
    - `monopoleConnectionCapacitiesPercent` number, nullable, required
    - `monopoleConnectionCapacitiesIsOk` boolean, nullable, required
    - `mountSlidingPercent` number, nullable
    - `mountSlidingIsOk` boolean, nullable
    - `mountOverturningPercent` number, nullable
    - `mountOverturningIsOk` boolean, nullable
    - `tiaServicabilityCheckUtilizationPercent` number, nullable
    - `tiaServicabilityCheckIsOk` boolean, nullable
    - `analysisRunId` string, uuid4, required
    - `createdBy` string
    - `designStandardType` 'EN' | 'TIA' | 'ASNZS', required

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server 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)