> For the complete documentation index, see [llms.txt](https://doc.re-cast.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.re-cast.ai/api-specification/recast-nwp.md).

# RE:Cast NWP

Provides real-time numerical weather forecast data. Processes past forecast data with user-specified filters, or combines one or more numerical forecast datasets into a single output.

For available model combination codes (`modelComb`), please contact the administrator.

## Timezone Notice

By default, all input and output times are based on **local time (KST)**. Only the **parameters that specify the forecast cycle** must be provided in **UTC**.

* Values input/output in **local time (KST)**:
  * `basetime` (`yyyymmddhhmmss`)
  * Variable values in the response: `issueddate` (`yyyymmdd`, str), `issuedhour` (`hhmm`, str)
  * Request parameters: `startTime`, `endTime` (`yyyymmddhhmmss`)
* Values that must be input in **UTC** (specifies the forecast cycle):
  * For `recent`: issue date and time `issuedDateCycle` (`yyyymmddhh`, UTC)
  * For `recent-dayahead`: issue hour `hh` (`hh`, UTC)

## most-recent

Returns the latest available cycle forecast. By selecting an NWP model combination, multiple model results can be retrieved in a single request.

{% openapi src="/files/a8hSHftgITVqrNWMsBK2" path="/nwp/v2/most-recent" method="get" %}
[nwp\_v2\_en.json](https://2078064603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2T1Itz8eCZrBiyNqVxMh%2Fuploads%2Fgit-blob-2c658acb5485e53bc1b067d46d136c5aa1da9557%2Fnwp_v2_en.json?alt=media)
{% endopenapi %}

## recent

Returns the cycle forecast for a specified issue date (within the last 90 days) and cycle. By selecting an NWP model combination, multiple model results can be retrieved in a single request.

{% openapi src="/files/a8hSHftgITVqrNWMsBK2" path="/nwp/v2/recent" method="get" %}
[nwp\_v2\_en.json](https://2078064603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2T1Itz8eCZrBiyNqVxMh%2Fuploads%2Fgit-blob-2c658acb5485e53bc1b067d46d136c5aa1da9557%2Fnwp_v2_en.json?alt=media)
{% endopenapi %}

## recent-dayahead

Over the last 14 days, returns only the D+1 forecasts issued at the cycle of the specified `hh` (UTC).

{% openapi src="/files/a8hSHftgITVqrNWMsBK2" path="/nwp/v2/recent-dayahead" method="get" %}
[nwp\_v2\_en.json](https://2078064603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2T1Itz8eCZrBiyNqVxMh%2Fuploads%2Fgit-blob-2c658acb5485e53bc1b067d46d136c5aa1da9557%2Fnwp_v2_en.json?alt=media)
{% endopenapi %}

## recent-latest

Across all cycles (identified by issue date and time `yyyymmddhh`) within the last 14 days, returns only the latest forecast for each `basetime`.

{% openapi src="/files/a8hSHftgITVqrNWMsBK2" path="/nwp/v2/recent-latest" method="get" %}
[nwp\_v2\_en.json](https://2078064603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2T1Itz8eCZrBiyNqVxMh%2Fuploads%2Fgit-blob-2c658acb5485e53bc1b067d46d136c5aa1da9557%2Fnwp_v2_en.json?alt=media)
{% endopenapi %}

## past

Returns results from past forecast data filtered by the specified basetime range and filter conditions. The `filters` parameter accepts conditions such as `dayoffset` and `issuedhour`, enabling requests of up to 3+ weeks. Data retention is capped at 90 days (S3 lifecycle).

{% openapi src="/files/a8hSHftgITVqrNWMsBK2" path="/nwp/v2/past" method="get" %}
[nwp\_v2\_en.json](https://2078064603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2T1Itz8eCZrBiyNqVxMh%2Fuploads%2Fgit-blob-2c658acb5485e53bc1b067d46d136c5aa1da9557%2Fnwp_v2_en.json?alt=media)
{% endopenapi %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.re-cast.ai/api-specification/recast-nwp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
