---
canonical_url: "https://docs.composio.dev/toolkits/accu_weather"
markdown_url: "https://docs.composio.dev/toolkits/accu_weather.md"
product: "platform"
version: null
last_updated: null
---

# AccuWeather

AccuWeather provides global current conditions, forecasts, alerts, MinuteCast precipitation forecasts, and lightning data.

- **Category:** places & weather
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 41
- **Triggers:** 0
- **Slug:** `ACCU_WEATHER`
- **Version:** 20261014_01
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Autocomplete Locations

**Slug:** `ACCU_WEATHER_AUTOCOMPLETE_LOCATIONS`

Return location-name suggestions for all locations, cities, or points of interest, optionally restricted to a country.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Partial location name to complete. |
| `language` | string | No | Language code for localized fields. |
| `country_code` | string | No | Optional country code restricting suggestions, such as US. |
| `location_type` | string ("all" | "city" | "point_of_interest") | No | Kind of suggestion to return: all locations, cities, or points of interest. |
| `include_aliases` | boolean | No | Whether to include matching alternate location names. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Administrative Area

**Slug:** `ACCU_WEATHER_GET_ADMINISTRATIVE_AREA`

Return one administrative area by country and administrative-area codes.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized fields. |
| `admin_code` | string | Yes | Administrative-area code. |
| `country_code` | string | Yes | Country code containing the administrative area. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Country

**Slug:** `ACCU_WEATHER_GET_COUNTRY`

Return one country by AccuWeather region and country codes.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized fields. |
| `region_code` | string | Yes | AccuWeather region code. |
| `country_code` | string | Yes | ISO or Microsoft localization country code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Conditions

**Slug:** `ACCU_WEATHER_GET_CURRENT_CONDITIONS`

Return current weather observations for an AccuWeather location key, optionally including extended details and weather photos.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include extended observation details. |
| `language` | string | No | Language code for localized fields. |
| `get_photos` | boolean | No | Whether to include photos representing the location and current weather. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Daily Forecast

**Slug:** `ACCU_WEATHER_GET_DAILY_FORECAST`

Return a 1, 5, 7, 10, or 15-day forecast for a location key.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | integer ("1" | "5" | "7" | "10" | "15") | No | Number of forecast days; selects a documented fixed horizon. |
| `metric` | boolean | No | Whether to return metric units instead of imperial units. |
| `details` | boolean | No | Whether to include extended forecast details. |
| `language` | string | No | Language code for localized fields. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Daily Indices

**Slug:** `ACCU_WEATHER_GET_DAILY_INDICES`

Return 1, 5, 10, or 15-day lifestyle-index forecasts for all indices, one group, or one index at an AccuWeather location.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | integer ("1" | "5" | "10" | "15") | No | Forecast horizon in days. |
| `details` | boolean | No | Whether to include extended index forecast details. |
| `group_id` | integer | No | Index group ID. Required only when selection is 'group'. |
| `index_id` | integer | No | Nonzero index ID, including provider-defined negative IDs. Required only when selection is 'index'; -1 is not a valid daily-forecast index ID. |
| `language` | string | No | Language code for localized fields. |
| `selection` | string ("all" | "group" | "index") | No | Return all indices, one index group, or one specific index. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Historical Current Conditions

**Slug:** `ACCU_WEATHER_GET_HISTORICAL_CURRENT_CONDITIONS`

Return the past 6 or 24 hours of current-condition observations for an AccuWeather location key.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hours` | integer ("6" | "24") | No | Historical window in hours. Use 6 or 24. |
| `details` | boolean | No | Whether to include extended observation details. |
| `language` | string | No | Language code for localized fields. |
| `get_photos` | boolean | No | Whether to include representative weather photos. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hourly Forecast

**Slug:** `ACCU_WEATHER_GET_HOURLY_FORECAST`

Return a 1, 12, 24, 72, or 120-hour forecast for an AccuWeather location key.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hours` | integer ("1" | "12" | "24" | "72" | "120") | No | Number of forecast hours; selects a documented fixed horizon. |
| `metric` | boolean | No | Whether to return metric units instead of imperial units. |
| `details` | boolean | No | Whether to include extended forecast details. |
| `language` | string | No | Language code for localized fields. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Index

**Slug:** `ACCU_WEATHER_GET_INDEX`

Return metadata for one AccuWeather lifestyle index.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `index_id` | integer | Yes | Lifestyle-index ID. |
| `language` | string | No | Language code for localized index metadata. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Index Group

**Slug:** `ACCU_WEATHER_GET_INDEX_GROUP`

Return the lifestyle indices belonging to one AccuWeather index group.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | Yes | Lifestyle-index group ID. |
| `language` | string | No | Language code for localized index metadata. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Lightning Forecast

**Slug:** `ACCU_WEATHER_GET_LIGHTNING_FORECAST`

Return forecast lightning probabilities for latitude/longitude coordinates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `coordinates` | string | Yes | Latitude followed by longitude in decimal degrees, separated by a comma. Lightning forecast coverage is latitude 20 to 55 and longitude -130 to -60, inclusive. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location

**Slug:** `ACCU_WEATHER_GET_LOCATION`

Return full location metadata for an AccuWeather location key.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include extended location details. |
| `language` | string | No | Language code for localized fields. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MinuteCast Forecast

**Slug:** `ACCU_WEATHER_GET_MINUTECAST_FORECAST`

Return minute-by-minute precipitation conditions for latitude/longitude coordinates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include detailed minute intervals when available. |
| `language` | string | No | Language code for localized precipitation phrases. |
| `coordinates` | string | Yes | Latitude followed by longitude in decimal degrees, separated by a comma. Latitude must be -90 to 90 and longitude -180 to 180. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Radar and Satellite Imagery

**Slug:** `ACCU_WEATHER_GET_RADAR_SATELLITE_IMAGERY`

Return recent radar and satellite image metadata and URLs for an AccuWeather location at a selected resolution.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized fields. |
| `resolution` | string ("480x480" | "640x480" | "1024x1024") | No | Requested image dimensions. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Region

**Slug:** `ACCU_WEATHER_GET_REGION`

Return one AccuWeather region by region code.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized fields. |
| `region_code` | string | Yes | AccuWeather region code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Translation Group

**Slug:** `ACCU_WEATHER_GET_TRANSLATION_GROUP`

Return translated strings for one AccuWeather translation group.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | Yes | Numeric identifier of the translation group to retrieve. |
| `language` | string | No | Language code for the translated strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tropical Storm Current Position

**Slug:** `ACCU_WEATHER_GET_TROPICAL_STORM_CURRENT_POSITION`

Return the latest observed position of a government-issued tropical storm.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `year` | integer | Yes | Four-digit storm year. |
| `basin` | string ("NP" | "CP" | "SP" | "EP" | "NI" | "SI" | "AL") | Yes | Tropical basin code. |
| `details` | boolean | No | Whether to include extended storm-position details. |
| `language` | string | No | Language code for localized fields. |
| `government_id` | integer | Yes | Government storm or depression ID. |
| `radii_geometry` | boolean | No | Whether to include wind-radii geometry. |
| `include_landmarks` | boolean | No | Whether to include nearby landmark information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Active Tropical Storms

**Slug:** `ACCU_WEATHER_LIST_ACTIVE_TROPICAL_STORMS`

Return active government-issued tropical storms globally, by basin, or by basin and government storm ID.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `basin` | string ("NP" | "CP" | "SP" | "EP" | "NI" | "SI" | "AL") | No | Optional tropical basin code used to restrict active storms. |
| `government_id` | integer | No | Optional government storm or depression ID. Requires basin. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Administrative Areas

**Slug:** `ACCU_WEATHER_LIST_ADMINISTRATIVE_AREAS`

Return administrative areas globally or within a country, one provider page at a time.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized fields. |
| `admin_code` | string | No | Optional administrative-area code used to filter the list. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `country_code` | string | No | Optional country code; when present, list only that country's administrative areas. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Countries

**Slug:** `ACCU_WEATHER_LIST_COUNTRIES`

Return countries globally or within a specific AccuWeather region, one provider page at a time.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized country names. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `region_code` | string | No | Optional AccuWeather region code; when present, list only countries in that region. |
| `country_code` | string | No | Optional ISO or Microsoft localization country code filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Index Groups

**Slug:** `ACCU_WEATHER_LIST_INDEX_GROUPS`

Return lifestyle-index groups and their identifiers.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized index-group fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Indices

**Slug:** `ACCU_WEATHER_LIST_INDICES`

Return all supported lifestyle indices and their identifiers.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized index metadata. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List MinuteCast Color Codes

**Slug:** `ACCU_WEATHER_LIST_MINUTECAST_COLOR_CODES`

Return full or simplified color-code metadata used in MinuteCast precipitation output.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `detail_level` | string ("full" | "simple") | No | Return the full or simplified MinuteCast color-code table. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Neighboring Cities

**Slug:** `ACCU_WEATHER_LIST_NEIGHBORING_CITIES`

Return cities near an AccuWeather location key.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include extended location details. |
| `language` | string | No | Language code for localized fields. |
| `location_key` | integer | Yes | Numeric AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Recent Lightning Strikes

**Slug:** `ACCU_WEATHER_LIST_RECENT_LIGHTNING_STRIKES`

Return recent lightning strikes within 1 to 60 miles of latitude/longitude coordinates as a GeoJSON FeatureCollection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `minutes` | integer ("5" | "15" | "30" | "60" | "120") | No | Lookback interval in minutes. |
| `coordinates` | string | Yes | Center latitude,longitude in decimal degrees. |
| `distance_radius` | integer | No | Search radius in miles, from 1 through 60. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Regions

**Slug:** `ACCU_WEATHER_LIST_REGIONS`

Return AccuWeather geographic regions and their codes.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized region names. |
| `region_code` | string | No | Optional AccuWeather region code used to filter the region list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Supported Languages

**Slug:** `ACCU_WEATHER_LIST_SUPPORTED_LANGUAGES`

Return AccuWeather-supported languages with numeric IDs and language codes.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Top Cities

**Slug:** `ACCU_WEATHER_LIST_TOP_CITIES`

Return top-ranked AccuWeather cities globally or within one region. Global rankings support 50, 100, or 150 results.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer ("50" | "100" | "150") | No | Number of cities to return. Valid only for global rankings; defaults to 50. |
| `details` | boolean | No | Whether to include extended location details. |
| `language` | string | No | Language code for global rankings; defaults to en-us and must be omitted for regional rankings. |
| `language_id` | integer | No | Numeric AccuWeather language ID for regional rankings; defaults to 1 and must be omitted for global rankings. |
| `region_code` | string | No | AccuWeather region code. Required only when ranking_scope is region. |
| `ranking_scope` | string ("global" | "region") | No | Rank cities globally or within one AccuWeather region. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Top City Conditions

**Slug:** `ACCU_WEATHER_LIST_TOP_CITY_CONDITIONS`

Return current weather conditions for a requested number of globally ranked cities.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized weather text. |
| `list_length` | integer ("50" | "100" | "150") | Yes | Number of globally ranked city condition records to return: 50, 100, or 150. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Translation Groups

**Slug:** `ACCU_WEATHER_LIST_TRANSLATION_GROUPS`

Return available AccuWeather translation groups and their identifiers.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code for localized translation group names. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tropical Storm Forecasts

**Slug:** `ACCU_WEATHER_LIST_TROPICAL_STORM_FORECASTS`

Return forecast positions and intensity for a government-issued tropical storm.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `year` | integer | Yes | Four-digit storm year. |
| `basin` | string ("NP" | "CP" | "SP" | "EP" | "NI" | "SI" | "AL") | Yes | Tropical basin code. |
| `details` | boolean | No | Whether to include extended storm forecast details. |
| `language` | string | No | Language code for localized fields. |
| `government_id` | integer | Yes | Government storm or depression ID. |
| `radii_geometry` | boolean | No | Whether to include wind-radii geometry. |
| `window_geometry` | boolean | No | Whether to include forecast uncertainty-window geometry. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tropical Storm Positions

**Slug:** `ACCU_WEATHER_LIST_TROPICAL_STORM_POSITIONS`

Return the observed position history of a government-issued tropical storm.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `year` | integer | Yes | Four-digit storm year. |
| `basin` | string ("NP" | "CP" | "SP" | "EP" | "NI" | "SI" | "AL") | Yes | Tropical basin code. |
| `details` | boolean | No | Whether to include extended storm-position details. |
| `language` | string | No | Language code for localized fields. |
| `government_id` | integer | Yes | Government storm or depression ID. |
| `radii_geometry` | boolean | No | Whether to include wind-radii geometry. |
| `include_landmarks` | boolean | No | Whether to include nearby landmark information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tropical Storms by Year

**Slug:** `ACCU_WEATHER_LIST_TROPICAL_STORMS_BY_YEAR`

Return government-issued tropical storms for a year, optionally filtered by basin and government storm ID.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `year` | integer | Yes | Four-digit storm year. |
| `basin` | string ("NP" | "CP" | "SP" | "EP" | "NI" | "SI" | "AL") | No | Optional tropical basin code. |
| `details` | boolean | No | Whether to include extended storm details. |
| `language` | string | No | Language code for localized fields. |
| `government_id` | integer | No | Optional government storm or depression ID. Requires basin. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tropical Storm Statuses

**Slug:** `ACCU_WEATHER_LIST_TROPICAL_STORM_STATUSES`

Return government-issued tropical storm status categories and wind-speed definitions globally or for one basin.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `basin` | string ("NP" | "CP" | "SP" | "EP" | "NI" | "SI" | "AL") | No | Optional tropical basin code; when present, return statuses for that basin. |
| `details` | boolean | No | Whether to include extended tropical storm status details. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Weather Alarms

**Slug:** `ACCU_WEATHER_LIST_WEATHER_ALARMS`

Return threshold-based weather alarms for the next 1, 5, 10, or 15 days at an AccuWeather location.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | integer ("1" | "5" | "10" | "15") | No | Alarm forecast horizon in days. |
| `language` | string | No | Language code for localized fields. |
| `location_key` | string | Yes | AccuWeather location key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Weather Alerts

**Slug:** `ACCU_WEATHER_LIST_WEATHER_ALERTS`

Return active government-issued weather alerts for a location key.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include extended alert details, including areas and text. |
| `language` | string | No | Language code for localized alert fields. |
| `location_key` | string | Yes | AccuWeather location key, such as 349727. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Language Identifier

**Slug:** `ACCU_WEATHER_RESOLVE_LANGUAGE_IDENTIFIER`

Convert an AccuWeather language code to its numeric ID or a numeric language ID to its code.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language_id` | integer | No | Positive AccuWeather language ID to resolve when identifier_type is id. |
| `language_code` | string | No | AccuWeather language code to resolve when identifier_type is code. |
| `identifier_type` | string ("code" | "id") | Yes | Whether to resolve a language code or a numeric language ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Administrative Areas

**Slug:** `ACCU_WEATHER_SEARCH_ADMINISTRATIVE_AREAS`

Search administrative areas by required non-empty name text and optional country and administrative-area code filters, one 25-result provider page at a time.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Required non-empty administrative-area name text to search for. |
| `language` | string | No | Language code for localized fields. |
| `admin_code` | string | No | Optional administrative-area code filter. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `country_code` | string | No | Optional ISO or Microsoft localization country code; when present, searches the country-scoped route. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search City by IP Address

**Slug:** `ACCU_WEATHER_SEARCH_CITY_BY_IP_ADDRESS`

Resolve an IPv4 or IPv6 address to an AccuWeather city location.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include extended location details. |
| `language` | string | No | Language code for localized fields. |
| `ip_address` | string | Yes | IPv4 or IPv6 address to resolve to the nearest AccuWeather city. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Locations

**Slug:** `ACCU_WEATHER_SEARCH_LOCATIONS`

Search cities, general locations, postal codes, or points of interest by text and optional geographic filters. Location and city searches return one 25-result page and may provide an opaque continuation cursor.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Location, city, postal code, or point-of-interest text to search. |
| `details` | boolean | No | Whether to include extended location details. |
| `language` | string | No | Language code for localized fields. |
| `admin_code` | string | No | Optional administrative-area restriction. Supported for location, city, and point_of_interest searches. |
| `alias_count` | integer | No | Number of aliases to return for location or city searches. |
| `next_cursor` | string | No | Opaque cursor returned by a previous location or city search; omit for the first page. |
| `country_code` | string | No | Optional country restriction. Required when admin_code is provided. |
| `all_languages` | boolean | No | Return point-of-interest matches in all languages; valid only when location_type is point_of_interest. |
| `location_type` | string ("location" | "city" | "postal_code" | "point_of_interest") | No | Resource family to search. |
| `point_of_interest_type` | string | No | Optional provider point-of-interest type filter; valid only when location_type is point_of_interest. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Locations by Coordinates

**Slug:** `ACCU_WEATHER_SEARCH_LOCATIONS_BY_COORDINATES`

Find the nearest general location, city, or point of interest to latitude/longitude coordinates.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.001 per 10 API calls

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `details` | boolean | No | Whether to include extended location details. |
| `language` | string | No | Language code for localized fields. |
| `top_level` | boolean | No | Whether to prefer the highest-ranked broader location instead of a neighborhood-level match. |
| `coordinates` | string | Yes | Latitude followed by longitude in decimal degrees, separated by a comma. Latitude must be -90 to 90 and longitude -180 to 180. |
| `location_type` | string ("location" | "city" | "point_of_interest") | No | Kind of nearby location to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |