> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenWeather API

> Provides access to current weather data, forecasts, and historical weather data for any location worldwide.

![OpenWeather API logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/openweather_api.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=2e6d72658361aa2b13fb9c38745855e6)

* **Category:** places & weather
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 21
* **Triggers:** 0
* **Slug:** `OPENWEATHER_API`
* **Version:** 20261101\_00

## Tools

> [accordion] Delete Weather Station
>
> **Slug:** `OPENWEATHER_API_DELETE_WEATHER_STATION`
>
> Tool to delete a registered weather station. Use after identifying a station to remove. Returns confirmation message upon success.
>
> #### Input Parameters
>
> **station\_id** `string` *required*
>
> The unique ID of the weather station to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get 5 Day Forecast
>
> **Slug:** `OPENWEATHER_API_GET5_DAY_FORECAST`
>
> Get a 5-day forecast at 3-hour intervals for a location identified by city name, city ID, postal code, or coordinates. Use the city timezone offset when grouping UTC timestamps into local daily summaries.
>
> #### Input Parameters
>
> **q** `string`
>
> City name and optional country code, e.g. 'London,uk'
>
> **id** `integer`
>
> OpenWeatherMap city ID
>
> **lat** `number`
>
> Latitude in degrees
>
> **lon** `number`
>
> Longitude in degrees
>
> **zip** `string`
>
> Zip code with country code, e.g. '94040,us'
>
> **lang** `string`
>
> Language code (ISO 639-1)
>
> **mode** `string ("json" | "xml" | "html")`
>
> Response format
>
> **units** `string ("standard" | "metric" | "imperial")`
>
> Units of measurement (standard, metric, imperial)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current Air Pollution Data
>
> **Slug:** `OPENWEATHER_API_GET_AIR_POLLUTION_CURRENT`
>
> Tool to fetch current air pollution data for a location. Use when you need real-time air quality details by latitude and longitude.
>
> #### Input Parameters
>
> **lat** `number` *required*
>
> Latitude of the location, between -90 and 90
>
> **lon** `number` *required*
>
> Longitude of the location, between -180 and 180
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Air Pollution Forecast
>
> **Slug:** `OPENWEATHER_API_GET_AIR_POLLUTION_FORECAST`
>
> Tool to get forecasted air pollution data for a specific location. Use after confirming latitude and longitude. Forecast availability may be limited for remote or oceanic coordinates; verify response timestamps to confirm returned data represents a true forecast rather than a current snapshot.
>
> #### Input Parameters
>
> **lat** `number` *required*
>
> Geographical latitude in decimal degrees (range -90 to 90)
>
> **lon** `number` *required*
>
> Geographical longitude in decimal degrees (range -180 to 180)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Air Pollution History
>
> **Slug:** `OPENWEATHER_API_GET_AIR_POLLUTION_HISTORY`
>
> Tool to retrieve historical air pollution data. Use when you need past air quality levels for a specific latitude/longitude and time range.
>
> #### Input Parameters
>
> **end** `integer` *required*
>
> End UNIX timestamp (UTC seconds); must be >= start
>
> **lat** `number` *required*
>
> Latitude of the location (range: -90 to 90)
>
> **lon** `number` *required*
>
> Longitude of the location (range: -180 to 180)
>
> **start** `integer` *required*
>
> Start UNIX timestamp (UTC seconds); must be \<= end
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Circle City Weather
>
> **Slug:** `OPENWEATHER_API_GET_CIRCLE_CITY_WEATHER`
>
> Search for current weather data in cities around a geographic point, with an optional number of cities to return.
>
> #### Input Parameters
>
> **cnt** `integer`
>
> Number of cities to return within the circle (1–50). Default is 10.
>
> **lat** `number` *required*
>
> Latitude of the circle center in degrees (-90 to 90)
>
> **lon** `number` *required*
>
> Longitude of the circle center in degrees (-180 to 180)
>
> **lang** `string`
>
> Language of the response (ISO 639-1)
>
> **mode** `string ("json" | "xml")`
>
> Response format: 'json' or 'xml'
>
> **units** `string ("standard" | "metric" | "imperial")`
>
> Units of measurement: standard, metric, or imperial
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current Weather
>
> **Slug:** `OPENWEATHER_API_GET_CURRENT_WEATHER`
>
> Retrieve current weather for a location identified by city name, city ID, postal code, or coordinates.
>
> #### Input Parameters
>
> **q** `string`
>
> City name, state code and country code, e.g., 'London,uk'
>
> **id** `integer`
>
> City ID, e.g., 2172797
>
> **lat** `number`
>
> Geographic coordinate latitude, e.g., 35.0
>
> **lon** `number`
>
> Geographic coordinate longitude, e.g., 139.0
>
> **zip** `string`
>
> Zip code and country code, e.g., '94040,us'
>
> **lang** `string`
>
> Language for the response (ISO 639-1 code, e.g., 'en')
>
> **units** `string ("standard" | "metric" | "imperial")`
>
> Units of measurement. 'standard' (default), 'metric', or 'imperial'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Geocoding by Zip Code
>
> **Slug:** `OPENWEATHER_API_GET_GEOCODING_BY_ZIP`
>
> Tool to convert zip/post code into geographic coordinates. Use when you need latitude and longitude for a specific postal code.
>
> #### Input Parameters
>
> **zip** `string` *required*
>
> Zip/post code and country code divided by comma. Use ISO 3166 country codes (e.g., '10001,US' or 'E14,GB').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Direct Geocoding
>
> **Slug:** `OPENWEATHER_API_GET_GEOCODING_DIRECT`
>
> Tool to convert a location name into geographic coordinates. Use when you need latitude and longitude for a given location after confirming the precise name.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Location query as 'city,country\_code', or 'city,state\_code,country\_code' for US locations. Use ISO 3166 country codes (e.g., 'London,GB' or 'Springfield,IL,US') and verify the returned country/region before using coordinates downstream.
>
> **limit** `integer`
>
> Number of results to return (1 to 5). Defaults to 5. Use 1 only for unambiguous locations; for ambiguous queries review all returned results to select the correct match.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reverse Geocoding
>
> **Slug:** `OPENWEATHER_API_GET_GEOCODING_REVERSE`
>
> Tool to convert geographic coordinates into a location name. Use when you need city, state, and country info from latitude and longitude.
>
> #### Input Parameters
>
> **lat** `number` *required*
>
> Latitude of the location in decimal degrees
>
> **lon** `number` *required*
>
> Longitude of the location in decimal degrees
>
> **limit** `integer`
>
> Number of results to return (1 to 5)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Station Measurements
>
> **Slug:** `OPENWEATHER_API_GET_STATION_MEASUREMENTS`
>
> Tool to retrieve aggregated measurements from a weather station with minute, hour, or day granularity. Use when you need historical weather data from a specific registered station.
>
> #### Input Parameters
>
> **to** `integer` *required*
>
> End of time interval (Unix timestamp in seconds)
>
> **from** `integer` *required*
>
> Start of time interval (Unix timestamp in seconds)
>
> **type** `string ("m" | "h" | "d")` *required*
>
> Aggregation type: m (minute), h (hour), or d (day)
>
> **limit** `integer` *required*
>
> Maximum number of measurement records to return
>
> **station\_id** `string` *required*
>
> Internal station ID from OpenWeather
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current UV Index
>
> **Slug:** `OPENWEATHER_API_GET_UV_INDEX`
>
> Tool to retrieve current UV index for a location. Use when you need up-to-the-minute UV index by latitude and longitude.
>
> #### Input Parameters
>
> **lat** `number` *required*
>
> Latitude of the location, between -90 and 90
>
> **lon** `number` *required*
>
> Longitude of the location, between -180 and 180
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get UV Index Forecast
>
> **Slug:** `OPENWEATHER_API_GET_UV_INDEX_FORECAST`
>
> Tool to retrieve UV index forecast for a specific location. Use when you need upcoming UV index values after confirming latitude and longitude. Returns up to 8 days of data. Data may be sparse or absent for ocean and remote locations; an empty response means no data available, not safe UV conditions.
>
> #### Input Parameters
>
> **cnt** `integer`
>
> Number of days to return (1-8); defaults to 8 if not specified
>
> **lat** `number` *required*
>
> Latitude of the location, between -90 and 90
>
> **lon** `number` *required*
>
> Longitude of the location, between -180 and 180
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get UV Index History
>
> **Slug:** `OPENWEATHER_API_GET_UV_INDEX_HISTORY`
>
> Tool to retrieve historical UV index data for a specified location and time range. Use when you need to analyze past UV exposure trends after confirming coordinates and time period.
>
> #### Input Parameters
>
> **end** `integer` *required*
>
> End UNIX timestamp (UTC seconds); must be >= start
>
> **lat** `number` *required*
>
> Latitude of the location (range: -90 to 90)
>
> **lon** `number` *required*
>
> Longitude of the location (range: -180 to 180)
>
> **start** `integer` *required*
>
> Start UNIX timestamp (UTC seconds); must be \<= end
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Weather Map Tile (2.0)
>
> **Slug:** `OPENWEATHER_API_GET_WEATHER_MAP_TILE`
>
> Tool to fetch Weather Maps 2.0 tile images. Use when you need dynamic weather layers at specific zoom and coordinates with advanced styling options.
>
> #### Input Parameters
>
> **x** `integer` *required*
>
> Tile X coordinate (non-negative integer).
>
> **y** `integer` *required*
>
> Tile Y coordinate (non-negative integer).
>
> **z** `integer` *required*
>
> Zoom level of the tile (non-negative integer).
>
> **fill** `string`
>
> Color for empty-data fill areas (hex or named).
>
> **color** `string`
>
> Color schema of the tiles, e.g., 'original', 'black'.
>
> **layer** `string ("clouds" | "clouds_new" | "precipitation" | "precipitation_new" | "pressure" | "pressure_new" | "wind" | "wind_new" | "temp" | "temp_new")` *required*
>
> Weather layer name. Options: clouds, clouds\_new, precipitation, precipitation\_new, pressure, pressure\_new, wind, wind\_new, temp, temp\_new.
>
> **scale** `integer ("1" | "2")`
>
> Tile scale factor: 1 or 2 for retina.
>
> **format** `string`
>
> Image format; only 'png' is supported.
>
> **opacity** `number`
>
> Tile opacity value between 0.0 and 1.0.
>
> **palette** `string`
>
> Custom palette definition (comma-separated or JSON).
>
> **fill\_bound** `boolean`
>
> Fill tiles outside data coverage if true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Weather Station
>
> **Slug:** `OPENWEATHER_API_GET_WEATHER_STATION`
>
> Tool to get information about a specific weather station by its ID. Use when you need details about a particular station.
>
> #### Input Parameters
>
> **station\_id** `string` *required*
>
> Internal station ID to retrieve information for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Weather Stations
>
> **Slug:** `OPENWEATHER_API_GET_WEATHER_STATIONS`
>
> Tool to list all weather stations added to your account. Use after setting up your OpenWeather API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Weather Triggers
>
> **Slug:** `OPENWEATHER_API_GET_WEATHER_TRIGGERS`
>
> Tool to retrieve weather triggers for specific conditions. Use after defining trigger criteria.
>
> #### Input Parameters
>
> **triggers** `array` *required*
>
> List of weather trigger definitions
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Weather Station
>
> **Slug:** `OPENWEATHER_API_POST_ADD_WEATHER_STATION`
>
> Tool to add a new weather station to your account. Use when you need to register a station before sending custom data.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Station name
>
> **altitude** `number` *required*
>
> Station altitude in meters above sea level
>
> **latitude** `number` *required*
>
> Station latitude, range -90 to 90 degrees
>
> **longitude** `number` *required*
>
> Station longitude, range -180 to 180 degrees
>
> **external\_id** `string` *required*
>
> External station ID (your own reference)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Station Measurements
>
> **Slug:** `OPENWEATHER_API_POST_SUBMIT_STATION_MEASUREMENTS`
>
> Tool to submit weather measurements from a registered station. Use when you need to send temperature, wind, pressure, humidity, or precipitation data for a station.
>
> #### Input Parameters
>
> **measurements** `array` *required*
>
> Array of measurement objects to submit
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Weather Station
>
> **Slug:** `OPENWEATHER_API_UPDATE_WEATHER_STATION`
>
> Update an existing weather station's details, including its name, location, external ID, or altitude. Latitude and longitude are required for every update.
>
> #### Input Parameters
>
> **name** `string`
>
> Human-readable name for the station
>
> **altitude** `number`
>
> Altitude of the station above sea level in meters
>
> **latitude** `number` *required*
>
> Latitude of the station in degrees, between -90 and 90
>
> **longitude** `number` *required*
>
> Longitude of the station in degrees, between -180 and 180
>
> **station\_id** `string` *required*
>
> Unique identifier of the weather station to update
>
> **external\_id** `string`
>
> Custom user-provided external identifier for the station
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
