---
title: "Portfolio Stress Test"
method: POST
path: "/api/portfolio/stress-test"
tags: ["Generate weather files"]
---

# Portfolio Stress Test

`POST /api/portfolio/stress-test`

## Request

- Base URL: `https://epw.tools`
- URL: `https://epw.tools/api/portfolio/stress-test`
- Auth: none declared. Required headers: `X-API-Key`

Lightweight climate stress-test for a portfolio of up to 50 locations.

For each site, returns:
- Current ASHRAE 169 climate zone, HDD, CDD (from design conditions data)
- Projected annual mean temperature delta (°C) under the chosen SSP + horizon
- Projected HDD change (estimated from annual delta)
- Projected peak cooling DB shift (from the July/August CMIP6 delta)
- Climate zone risk flag if the zone number changes

No credits consumed — uses pre-cached CMIP6 monthly deltas.
Requires a valid API key.

## Headers

- `X-API-Key` string, required

## Request body

- PortfolioStressTestRequest
  - `sites` PortfolioSite[], required
    - `lat` number, required
    - `lon` number, required
    - `label` string, required
    - `dc_edition` string
  - `scenario` string
  - `horizon` integer
  - `model` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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