> For the complete documentation index, see [llms.txt](https://docs.diaflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diaflow.io/studio/nodes/action-nodes/get-weather-information.md).

# Get Weather Information

Retrieve current, forecast, or historical weather data for a location.

## Get Weather Information

### What does it do?

The **Get Weather Information** node pulls live or past weather details for a location. Think of it like a weather desk assistant that checks the conditions for you before your workflow sends alerts, plans field work, or builds reports.

#### Smart Features

* **Supports three weather modes**: Get **Current weather**, a future **Forecast**, or **History** for past dates.
* **Works with dynamic values**: You can fill the location and dates from earlier workflow steps using **@**.
* **Accepts several location formats**: Use a city, city and country, coordinates, postal code, IP address, or airport code.
* **Returns detailed weather data**: The output includes location details, conditions, temperatures, and more.
* **Shows service errors clearly**: If the weather service cannot match the location or date, the node returns that message.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FGdYhzTA4YQfNKCUkuwhc%2Fcursorful-video-1778579911956.gif?alt=media&amp;token=da976c24-a414-4e90-b508-9fe024523068" alt=""><figcaption></figcaption></figure>

### Real-World Business Value

* Add tomorrow’s forecast to logistics updates before dispatching drivers or field teams.
* Check historical weather during incident reviews, delivery analysis, or insurance reporting.
* Personalize customer messages based on local weather in each contact’s city.

### Step-by-Step Setup

* In the **Type** field, choose **Current weather**, **Forecast**, or **History**.
* In the **Value** field, enter the location you want to check.
* Use a simple format in **Value**, such as `London`, `Paris, France`, `48.8566,2.3522`, or `CDG`.
* If you choose **Forecast**, enter **Day** with a number from `1` to `14`.
* If you want one specific forecast date, enter that date in `YYYY-MM-DD` format.
* If you choose **History**, fill **Start date** and **End date** in `YYYY-MM-DD` format.
* Make sure **End date** is later than **Start date**.
* If your location comes from an earlier step, insert it with **@** instead of typing it manually.
* Run the workflow and review the returned weather details in the output.

### The Transformation: Before & After

**Before**

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FgPs6efxhRz30oKc51kBy%2Frounded-image%20(83).png?alt=media&amp;token=e3c49228-b1df-464c-b3eb-3151dd66e0dc" alt=""><figcaption></figcaption></figure>

**After**

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2Ftdw5s5wIjLP8BVBlNcoe%2Frounded-image%20(82).png?alt=media&amp;token=b3d728cc-27de-4a80-b8b0-a83e191f9c0c" alt=""><figcaption></figcaption></figure>

### Tips &  Warnings for First-Timers

* Use a clear location in **Value**. If the place name is vague, add the country.
* Always enter dates in `YYYY-MM-DD` format. Other date formats can fail.
* For **Forecast**, keep **Day** between `1` and `14`.
* For **History**, fill both **Start date** and **End date**. Leaving one blank can cause errors.
* Do not use an unsupported **Type** value. Stick to **Current weather**, **Forecast**, or **History**.
* Large forecast or history responses can contain a lot of detail. If a later AI step only needs a few fields, filter the result first.
* This node makes a fresh lookup every time. If you run the same workflow often, expect the weather data to refresh each run.
* Slow network responses can delay the workflow. Retry if the weather service is temporarily unavailable.

### Need help?

* Learn the basics in [How a node works](/studio/lets-start-with-the-basics/how-a-node-works.md)
* Build the full flow in [Create a workflow](/studio/manage-a-workflow/create-a-workflow.md)
* Browse related nodes in [Component List](/studio/component-list.md)