---
title: "V1 Generate Future Climate"
method: POST
path: "/api/v1/generate/future-climate"
tags: ["Generate weather files"]
---

# V1 Generate Future Climate

`POST /api/v1/generate/future-climate`

## Request

- Base URL: `https://epw.tools`
- URL: `https://epw.tools/api/v1/generate/future-climate`
- Auth: API key in header `X-API-Key`

Generate a CMIP6-morphed future-climate EPW (v1 of
/api/generate/future-climate). Returns {job_id}.

## Headers

- `X-API-Key` string, nullable

## Request body

- FutureClimateRequest
  - `lat` number, required
  - `lon` number, required
  - `location_name` string, required
  - `base_year` integer
  - `scenario` string
  - `horizon` integer
  - `model` string
  - `dc_edition` string
  - `method` 'belcher' | 'eames_bounded' | 'reolon_idw' | 'qm'

## Response `200`

Successful Response

- unknown

## Other responses

- `402`: Insufficient credits for this operation.
- `422`: Validation Error
- `429`: Rate limit exceeded — retry after a short delay.

---

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