---
title: "Actual year (AMY) for any coordinates"
method: POST
path: "/api/generate/individual"
tags: ["Generate weather files"]
---

# Actual year (AMY) for any coordinates

`POST /api/generate/individual`

## Request

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

One actual meteorological year for any latitude/longitude. 1 credit.

Starts a background job and returns `{"job_id": ...}` immediately. Credits are charged on submission and refunded if the job fails; the balance after the call is in the `X-Credits-Remaining` response header. Then poll `GET /api/jobs/{job_id}`, stream `/api/jobs/{job_id}/stream`, or register a webhook.

## Headers

- `X-API-Key` string, nullable

## Request body

- IndividualRequest
  - `lat` number, required
  - `lon` number, required
  - `location_name` string, required
  - `year` integer, required
  - `file_type` string
  - `data_source` string
  - `leap_day` string
  - `dc_edition` string
  - `apply_uhi` boolean: Auto-apply data-driven UHI correction after generation
  - `urban_street_level` boolean: Also write *_urban.epw: street-level dry-bulb from citizen (CWOP) stations (US cities, years with an archive)
  - `station_id` string, nullable

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