---
title: "Get Eurocode Site Assessment"
method: POST
path: "/v1/site/eurocode-site-assessment"
tags: ["site"]
---

# Get Eurocode Site Assessment

`POST /v1/site/eurocode-site-assessment`

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

Site inputs of EN 1991-1-4 for a location, per wind direction, under the generic Eurocode or a national annex.

## Request body

- EurocodeSiteAssessmentInput
  - `latitude` number, required
  - `longitude` number, 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
  - `windProfileHeightM` number, required
  - `globalWindDirections` number[], required
  - `siteAltitudeM` number, nullable: Annexes that require an altitude look it up from terrain data when it is left out.
  - `radiusOfScannedTopographyM` number

## Response `200`

Successful Response

- EurocodeSiteAssessmentView
  - `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
  - `siteAltitudeM` number, required: The site altitude used, in m.
  - `v_b0_MS` number, required: The fundamental value of the basic wind velocity in m/s, including the altitude factor where the annex has one.
  - `v_b_map_MS` number, nullable: UK and Irish National Annexes only: the map value of the basic wind velocity in m/s, before the altitude factor.
  - `directionalAssessments` EurocodeSiteDirectionalAssessmentView[], required
    - `globalWindDirection` number, required
    - `terrainCategory` 'EN_0' | 'EN_1' | 'EN_2' | 'EN_3' | 'EN_4' | 'EN_NF_0' | 'EN_NF_2' | 'EN_NF_3a' | 'EN_NF_3b' | 'EN_NF_4' | 'EN_SFS_0' | 'EN_SFS_0p' | 'EN_SFS_1' | 'EN_SFS_2' | 'EN_SFS_2p' | 'EN_SFS_3' | 'EN_SFS_4' | 'EN_DIN_1' | 'EN_DIN_COAST' | 'EN_DIN_2' | 'EN_DIN_INLAND' | 'EN_DIN_3' | 'EN_DIN_4' | 'EN_BS_TOWN' | 'EN_BS_COUNTRY' | 'EN_UNI_1' | 'EN_UNI_2' | 'EN_UNI_3' | 'EN_UNI_4' | 'EN_UNI_5' | 'ASNZS_1' | 'ASNZS_2' | 'ASNZS_25' | 'ASNZS_3' | 'ASNZS_4' | 'TIA_222_CAT_B' | 'TIA_222_CAT_C' | 'TIA_222_CAT_D' | 'UNKNOWN', required
    - `orographyData` SiteOrographyView
      - `feature` 'flat' | 'ft_hill' | 'hill' | 'ft_ridge' | 'ridge' | 'rolling_ridge' | 'rolling_hill' | 'escarpment' | 'na', required
      - `H` number, required
      - `X` number, required
      - `L_up` number, required
      - `L_down` number, nullable, required
      - `construction_points` ConstructionPointsEntityOutput
        - `upwind_slope` SlopeConstructionPointsEntity
          - `point_A` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_B` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_C` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_D` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_E` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
        - `downwind_slope` SlopeConstructionPointsEntity
          - `point_A` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_B` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_C` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_D` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
          - `point_E` TerrainProfilePointEntity
            - `point_index` integer, nullable
            - `distance_from_start_m` number, required
            - `altitude_m` number, required
    - `cDir` number, required
    - `distanceUpwindShorelineKm` number, nullable: UK and Irish National Annexes only.
    - `distanceInsideTownKm` number, nullable: UK and Irish National Annexes only, and only in town terrain.

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