---
title: "Use when you want to know if the weather conditions are optimal for a specific
activity such as outdoor sporting activities, construction, or farming (results
includes soil moisture information)."
method: GET
path: "/weather/indices/daily/{format}"
---

# Use when you want to know if the weather conditions are optimal for a specific
activity such as outdoor sporting activities, construction, or farming (results
includes soil moisture information).

`GET /weather/indices/daily/{format}`

The `Get Daily Indices` API is an HTTP `GET` request returns index values that
provide guidance to help when planning future activities. For example, a health
mobile application can notify users that today is good weather for running or
for other outdoors activities like playing golf or flying a kite. Retail stores
can optimize their digital marketing campaigns based on predicted index values.
The service returns in daily indices values for current and next 5, 10 and 15
days starting from current day.

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `query` number[], required
- `language` string
- `duration` integer
- `indexId` integer
- `indexGroupId` integer

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- DailyIndicesResult — This object is returned from a successful Get Daily Indices call.
  - `results` DailyIndex[] — A list of all daily indices for the queried location.
    - `indexName` string — The name of the index, indicating the type of activity or condition it relates to, such as running, golfing, or other outdoor activities. For more information, see [Index IDs](/azure/azure-maps/weather-services-concepts#index-ids-and-index-groups-ids) in the *Weather service in Azure Maps* concepts article.
    - `indexId` integer — A numeric identifier that uniquely represents a specific index type, distinguishing between different indices for various outdoor activities. For example, an 'indexId' of 1 corresponds to the 'Running' index, and an 'indexId' of 5 corresponds to the 'Golfing' index. For more information, see [Index IDs](/azure/azure-maps/weather-services-concepts#index-ids-and-index-groups-ids) in the *Weather service in Azure Maps* concepts article.
    - `dateTime` string, date-time — Date and time of the observation in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*.
    - `value` number, float — A numerical index value ranging from 0.0 to 10.0 that quantifies the suitability of weather conditions for a specific activity or condition, such as running or golfing. Higher values typically indicate more favorable conditions, depending on the value of the `ascending` property. For example, a value of 8 for the 'Running' index suggests very good weather for running, while a value of 6 for the 'Golfing' index indicates good but slightly less ideal conditions. For more information, see [Daily index range sets](/azure/azure-maps/daily-index-range-sets) in the *Weather service in Azure Maps* concepts article.
    - `category` string — Provides a qualitative assessment of the index, describing the `categoryValue` property. Categories vary among indices and may include values such as Excellent, Very Good, Good, Fair, and Poor.
    - `categoryValue` integer — Provides a numeric representation of the category property, indicating the qualitative assessment of the index. Values range from 1 to 5 and should be used with the ascending flag, as they can differ among indices. For example, for Mosquito Activity: Low=1, Moderate=2, High=3, Very High=4, Extreme=5.
    - `ascending` boolean — Indicates the direction of the `value` and `categoryValue` properties. When true, the poorest index value is 0 and the best index value is 10. When false, the poorest index value is 10 and the best index value is 0.
    - `description` string — Provides a brief, user-friendly explanation of the index value, helping users understand its significance in relation to specific weather conditions or activities. For example, if the index value for Outdoor Barbecue is 'Excellent', the description will be 'This is a great day for an outdoor barbecue!'

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