---
title: "Calculate Epa Capacity"
method: POST
path: "/v1/epa/calculate-capacity"
tags: ["epa"]
---

# Calculate Epa Capacity

`POST /v1/epa/calculate-capacity`

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

## Request body

- EpaCapacityCalculationInput
  - `ancillaryData` AncillaryDataInput[], required
    - `geometry` union, required
      - BoxGeometry
        - `shape` 'BOX'
        - `widthMm` number, required
        - `heightMm` number, required
        - `depthMm` number, required
        - `radiusMm` number, required
      - DishGeometry
        - `shape` 'DISH'
        - `diameterMm` number, required
      - DishWithShroudGeometry
        - `shape` 'DISH_SHROUD'
        - `diameterMm` number, required
      - CylinderGeometry
        - `shape` 'CYLINDER'
        - `diameterMm` number, required
        - `heightMm` number, required
      - PlaneLatticeGeometry
        - `shape` 'PLANE_LATTICE'
        - `widthMm` number, required
        - `heightMm` number, required
        - `depthMm` number, required
        - `frontAreaMm2` number, required
        - `sideAreaMm2` number, required
    - `azimuthDeg` number, required
    - `elevationM` number, required: Elevation of the ancillary (m) above ground level.
    - `mountOption` 'TOP' | 'MIDDLE' | 'BOTTOM', required
    - `shieldingFactor` number: Factor to reduce the EPA to account for shielding effects from other ancillaries on the tower.
  - `towerCapacityM2` number, required: The tower's EPA capacity (m²).
  - `capacityElevationM` number, required: Where on the tower the tower capacity (m) should be applied.

## Response `200`

Successful Response

- EpaCapacityCalculationView
  - `governingWindDirection` number, required: The wind direction (deg) with the maximum applied EPA.
  - `designEpaM2` number, required: The calculated EPA (m²) for the ancillaries on the tower.
  - `designEpaWithSteelworkM2` number, required: The calculated EPA (m²) with assumed 5% extra area for steelwork for the ancillaries on the tower.
  - `designEpaAtElevationM2m` number, required: The calculated EPA (m²·m) of the ancillaries applied at the specified elevation.
  - `designEpaAtElevationWithSteelworkM2m` number, required: The calculated EPA (m²·m) with assumed 5% extra area for steelwork of the ancillaries applied at the specified elevation.
  - `towerCapacityM2` number, required: The specified tower capacity (m²).
  - `capacityElevationM` number, required: The specified elevation (m) for the tower capacity.
  - `availableEpaM2m` number, required: The available EPA (m²·m) at the capacity elevation. A negative number signifies an overloaded structure.
  - `allowableEpaM2m` number, required: The allowable EPA (m²·m) at the capacity elevation.
  - `utilizationPercent` number, required: The ratio (%) of applied EPA at elevation to allowable EPA at elevation.

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