---
title: "Use to get a minute-by-minute forecast for the next 120 minutes in intervals of
1, 5 and 15 minutes."
method: GET
path: "/weather/forecast/minute/{format}"
---

# Use to get a minute-by-minute forecast for the next 120 minutes in intervals of
1, 5 and 15 minutes.

`GET /weather/forecast/minute/{format}`

The `Get Minute Forecast` API is an HTTP `GET` request that returns
minute-by-minute forecasts for a given location for the next 120 minutes.
Users can request weather forecasts in intervals of 1, 5 and 15 minutes.  The
response will include details such as the type of precipitation (including
rain, snow, or a mixture of both), start time, and precipitation intensity
value (dBZ). For more information, see [Request minute-by-minute weather
forecast
data](/azure/azure-maps/how-to-request-weather-data#request-minute-by-minute-weather-forecast-data).

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `query` number[], required
- `interval` integer
- `language` string

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- MinuteForecastResult — Minute-by-minute weather forecast result.
  - `summary` MinuteForecastSummary — Phrase summaries for the entire forecast period.
    - `briefPhrase60` string — Summary phrase for the next 60 minutes. Phrase length is approximately 60 characters.
    - `shortPhrase` string — Short summary phrase for the next 120 minutes. Phrase length is approximately 25 characters.
    - `briefPhrase` string — Summary phrase for the next 120 minutes. Phrase length is approximately 60 characters.
    - `longPhrase` string — Long summary phrase for the next 120 minutes. Phrase length is 60+ characters.
    - `iconCode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 — Numeric value representing an image that corresponds to the current weather condition described by the `Phrase` property. For more information, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#weather-icons). May be NULL.
  - `intervalSummaries` IntervalSummary[] — Summary information for each interval in the forecast. The Summaries breaks down each potential interval where precipitation starts and stops.
    - `startMinute` integer — The first minute to which the summary applies.
    - `endMinute` integer — The last minute to which the summary applies.
    - `totalMinutes` integer — The number of minutes for which the summary applies.
    - `shortPhrase` string — Short summary phrase. Phrase length is approximately 25 characters.
    - `briefPhrase` string — Brief summary phrase. Phrase length is approximately 60 characters.
    - `longPhrase` string — Long summary phrase. Phrase length is 60+ characters.
    - `iconCode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 — Numeric value representing an image that corresponds to the current weather condition described by the `Phrase` property. For more information, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#weather-icons). May be NULL.
  - `intervals` ForecastInterval[] — Forecast data for each interval in the forecast.
    - `startTime` string, date-time — The date and time for the start of the interval in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27T19:39:57-08:00.
    - `minute` integer — The first minute for the interval.
    - `dbz` number, double — A unit that represents forecasted precipitation intensity.
    - `shortPhrase` string — A short phrase describing precipitation condition for the interval.
    - `threshold` string — Key that specifies the threshold value. Along with precipitationType, can be used to determine the simplifiedColor. If dBZ is zero, not present in the response.
    - `color` ColorValue — Color value represented as RGB and hexadecimal.
      - `red` integer — Red component of the RGB value.
      - `green` integer — Green component of the RGB value.
      - `blue` integer — Blue component of the RGB value
      - `hex` string — Hexadecimal color value.
    - `simplifiedColor` ColorValue — Color value represented as RGB and hexadecimal.
      - `red` integer — Red component of the RGB value.
      - `green` integer — Green component of the RGB value.
      - `blue` integer — Blue component of the RGB value
      - `hex` string — Hexadecimal color value.
    - `precipitationType` 'Ice' | 'Mix' | 'Rain' | 'Snow' — Specifies the type of precipitation. Valid values are Rain, Snow, Ice, or Mix. This property is included in the response when dBZ is greater than zero.
    - `iconCode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 — Numeric value representing an image that corresponds to the current weather condition described by the `Phrase` property. For more information, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#weather-icons). May be NULL.
    - `cloudCover` integer — Percent representing cloud cover.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/versions/3c076fdd2918/schema)