---
title: "Get Asce Preview"
method: GET
path: "/v1/site/tia/asce/preview/{structure_id}"
tags: ["site/tia/asce"]
---

# Get Asce Preview

`GET /v1/site/tia/asce/preview/{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/site/tia/asce/preview/{structure_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

## Path parameters

- `structure_id` string, required

## Query parameters

- `soilClass` 'A' | 'B' | 'BC' | 'C' | 'CD' | 'D' | 'DE' | 'E'

## Response `200`

Successful Response

- AscePreviewView
  - `fetchedAt` string, date-time, required
  - `standardsVersion` string, required
  - `riskLevel` integer, required
  - `isDummy` boolean, required
  - `wind` WindCategoryView, required
    - `status` 'ok' | 'not_applicable' | 'unavailable', required
    - `current` WindCurrentView
      - `basicWindSpeedWithoutIceMs` number, nullable, required
      - `isHurricaneProneRegion` boolean, required
    - `proposed` WindProposedView
      - `mappingVersion` integer, required
      - `basicWindSpeedWithoutIceMs` number, nullable, required
      - `isHurricaneProneRegion` boolean, required
    - `currentHash` string, nullable
    - `proposedHash` string, nullable
    - `isDrifted` boolean
    - `isOverridden` boolean
    - `unavailableReason` 'location_not_supported' | 'rate_limited' | 'authentication_failed' | 'upstream_error' | 'unknown_error'
  - `ice` IceCategoryView, required
    - `status` 'ok' | 'not_applicable' | 'unavailable', required
    - `current` IceCurrentView
      - `enabled` boolean, required
      - `thicknessMm` number, nullable, required
      - `densityKgPerM3` number, nullable, required
      - `concurrentWindWithIceMs` number, nullable, required
    - `proposed` IceProposedView
      - `mappingVersion` integer, required
      - `enabled` boolean, required
      - `thicknessMm` number, nullable, required
      - `densityKgPerM3` number, nullable, required
      - `concurrentWindWithIceMs` number, nullable, required
    - `currentHash` string, nullable
    - `proposedHash` string, nullable
    - `isDrifted` boolean
    - `isOverridden` boolean
    - `unavailableReason` 'location_not_supported' | 'rate_limited' | 'authentication_failed' | 'upstream_error' | 'unknown_error'
  - `seismic` SeismicCategoryView, required
    - `status` 'ok' | 'not_applicable' | 'unavailable', required
    - `current` SeismicCurrentView
      - `enabled` boolean, required
      - `soilClass` string, nullable, required
      - `sDs` number, nullable, required
      - `sD1` number, nullable, required
      - `s1` number, nullable, required
      - `tLSeconds` number, nullable, required
    - `proposed` SeismicProposedView
      - `mappingVersion` integer, required
      - `enabled` boolean, required
      - `soilClass` string, required
      - `sDs` number, nullable, required
      - `sD1` number, nullable, required
      - `s1` number, nullable, required
      - `tLSeconds` number, nullable, required
    - `currentHash` string, nullable
    - `proposedHash` string, nullable
    - `isDrifted` boolean
    - `isOverridden` boolean
    - `unavailableReason` 'location_not_supported' | 'rate_limited' | 'authentication_failed' | 'upstream_error' | 'unknown_error'
  - `tornado` TornadoCategoryView, required
    - `status` 'ok' | 'not_applicable' | 'unavailable', required
    - `current` TornadoCurrentView
      - `included` boolean, required
      - `tornadoWindSpeedMs` number, nullable, required
      - `exclusionKind` string, nullable, required
      - `exclusionThreshold` number, nullable, required
    - `proposed` TornadoProposedView
      - `mappingVersion` integer, required
      - `included` boolean, required
      - `tornadoWindSpeedMs` number, nullable, required
      - `exclusionKind` string, nullable, required
      - `exclusionThreshold` number, nullable, required
    - `currentHash` string, nullable
    - `proposedHash` string, nullable
    - `isDrifted` boolean
    - `isOverridden` boolean
    - `unavailableReason` 'location_not_supported' | 'rate_limited' | 'authentication_failed' | 'upstream_error' | 'unknown_error'

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