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

# POST /v1/history:lookup

`POST /v1/history:lookup`

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

## Request body

- LookupHistoryRequest — The request object of the air quality history API.
  - `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 value is en.
  - `pageSize` integer — Optional. The maximum number of hourly info records to return per page. The default is 72 and the max value is 168 (7 days of data).
  - `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.
  - `universalAqi` boolean — Optional. If set to true, the Universal AQI will be included in the 'indexes' field of the response. Default value is true.
  - `hours` integer — Number from 1 to 720 that indicates the hours range for the request. For example: A value of 48 will yield data from the last 48 hours.
  - `pageToken` string — Optional. A page token received from a previous history call. It is used to retrieve the subsequent page. Note that when providing a value for this parameter all other parameters provided must match the call that provided the page token (the previous call).
  - `dateTime` string, google-datetime — A timestamp for which to return historical data. 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 dateTime parameter is set to 2023-01-03T11:05:49Z will be rounded down to 2023-01-03T11:00:00Z. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
  - `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.

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