---
title: "POST /v1/forecast:lookup"
method: POST
path: "/v1/forecast:lookup"
tags: ["forecast"]
---

# POST /v1/forecast:lookup

`POST /v1/forecast:lookup`

Returns air quality forecast for a specific location for a given time range.

## Request body

- LookupForecastRequest — The request object of the air quality forecast API.
  - `pageToken` string — Optional. A page token received from a previous forecast call. It is used to retrieve the subsequent page.
  - `dateTime` string, google-datetime — A timestamp for which to return the data for a specific point in time. The timestamp is rounded to the previous exact hour. Note: this will return hourly data for the requested timestamp only (i.e. a single hourly info element). For example, a request sent where the date_time parameter is set to 2023-01-03T11:05:49Z will be rounded down to 2023-01-03T11:00:00Z.
  - `extraComputations` string[] — Optional. Additional features that can be optionally enabled. Specifying extra computations will result in the relevant elements and fields to be returned in the response.
  - `customLocalAqis` CustomLocalAqi[] — Optional. Expresses a 'country/region to AQI' relationship. Pairs a country/region with a desired AQI so that air quality data that is required for that country/region will be displayed according to the chosen AQI. This parameter can be used to specify a non-default AQI for a given country, for example, to get the US EPA index for Canada rather than the default index for Canada.
    - `aqi` string — The AQI to associate the country/region with. Value should be a [valid index](/maps/documentation/air-quality/laqis) code.
    - `regionCode` string — The country/region requiring the custom AQI. Value should be provided using [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
  - `period` Interval — Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.
    - `startTime` string, google-datetime — Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
    - `endTime` string, google-datetime — Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
  - `pageSize` integer — Optional. The maximum number of hourly info records to return per page (default = 24).
  - `universalAqi` boolean — Optional. If set to true, the Universal AQI will be included in the 'indexes' field of the response (default = true).
  - `uaqiColorPalette` 'COLOR_PALETTE_UNSPECIFIED' | 'RED_GREEN' | 'INDIGO_PERSIAN_DARK' | 'INDIGO_PERSIAN_LIGHT' — Optional. Determines the color palette used for data provided by the 'Universal Air Quality Index' (UAQI). This color palette is relevant just for UAQI, other AQIs have a predetermined color palette that can't be controlled.
  - `location` LatLng — An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.
    - `latitude` number, double — The latitude in degrees. It must be in the range [-90.0, +90.0].
    - `longitude` number, double — The longitude in degrees. It must be in the range [-180.0, +180.0].
  - `languageCode` string — Optional. Allows the client to choose the language for the response. If data cannot be provided for that language the API uses the closest match. Allowed values rely on the IETF standard (default = 'en').

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/airquality.md) · [All operations](https://skmtc.dev/google/apis/airquality/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/airquality/revisions/d1c3e2eb2ef0/schema)