Core Weather

List

Endpointhttps://dataservice.accuweather.com

Top 50 cities list

GET

https://dataservice.accuweather.com

/locations/v1/topcities/50

Returns location data for the top 50 cities, worldwide

Top 50 cities list › query Parameters

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

format

string

A string value that specifies what type of format to provide the response.

Default: json

Top 50 cities list › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top 50 cities list › Responses

object[]

PrimaryPostalCode

string · minLength: 1 · required

Official postal code provided by our main location data provider for the requested location

object · required

IsAlias

boolean · required

“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location

object[] · required

The object containing a list of administrative area details

DataSets

string[] · required

Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.

EnglishName

string · minLength: 1 · required

Location name as displayed in English

Version

integer · int32 · required

Current version of the API

Key

string · minLength: 1 · required

Unique ID to search a location

Type

string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank

integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName

string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required

object

GET/locations/v1/topcities/50

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/topcities/50 \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "PrimaryPostalCode": "PrimaryPostalCode",
    "Region": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "TimeZone": {
      "Code": "Code",
      "NextOffsetChange": "2024-08-25T15:00:00Z",
      "Name": "Name",
      "GmtOffset": 0,
      "IsDaylightSaving": true
    },
    "GeoPosition": {
      "Elevation": {
        "Metric": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        },
        "Imperial": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        }
      },
      "Latitude": 0,
      "Longitude": 0
    },
    "IsAlias": true,
    "ParentCity": {
      "Key": "Key",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "SupplementalAdminAreas": [
      {
        "Level": 0,
        "LocalizedName": "LocalizedName",
        "EnglishName": "EnglishName"
      }
    ],
    "DataSets": [
      "string"
    ],
    "Details": {
      "Key": "Key",
      "StationCode": "StationCode",
      "StationGmtOffset": 0,
      "BandMap": "BandMap",
      "Climo": "Climo",
      "LocalRadar": "LocalRadar",
      "MediaRegion": "MediaRegion",
      "Metar": "Metar",
      "NXMetro": "NXMetro",
      "NXState": "NXState",
      "Population": 0,
      "PrimaryWarningCountyCode": "PrimaryWarningCountyCode",
      "PrimaryWarningZoneCode": "PrimaryWarningZoneCode",
      "Satellite": "Satellite",
      "Synoptic": "Synoptic",
      "MarineStation": "MarineStation",
      "MarineStationGMTOffset": 0,
      "VideoCode": "VideoCode",
      "LocationStem": "LocationStem",
      "DMA": {
        "ID": "ID",
        "EnglishName": "EnglishName"
      },
      "PartnerID": {},
      "Sources": [
        {
          "DataType": "DataType",
          "Source": "Source",
          "SourceId": 0,
          "PartnerSourceUrl": {}
        }
      ],
      "CanonicalPostalCode": "CanonicalPostalCode",
      "CanonicalLocationKey": "CanonicalLocationKey"
    },
    "EnglishName": "EnglishName",
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]

json

application/json

Top 100 cities list

GET

https://dataservice.accuweather.com

/locations/v1/topcities/100

Returns location data for the top 100 cities, worldwide

Top 100 cities list › query Parameters

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

format

string

A string value that specifies what type of format to provide the response.

Default: json

Top 100 cities list › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top 100 cities list › Responses

object[]

PrimaryPostalCode

string · minLength: 1 · required

Official postal code provided by our main location data provider for the requested location

object · required

IsAlias

boolean · required

“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location

object[] · required

The object containing a list of administrative area details

DataSets

string[] · required

EnglishName

string · minLength: 1 · required

Location name as displayed in English

Version

integer · int32 · required

Current version of the API

Key

string · minLength: 1 · required

Unique ID to search a location

Type

string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank

integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName

string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required

object

GET/locations/v1/topcities/100

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/topcities/100 \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "PrimaryPostalCode": "PrimaryPostalCode",
    "Region": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "TimeZone": {
      "Code": "Code",
      "NextOffsetChange": "2024-08-25T15:00:00Z",
      "Name": "Name",
      "GmtOffset": 0,
      "IsDaylightSaving": true
    },
    "GeoPosition": {
      "Elevation": {
        "Metric": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        },
        "Imperial": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        }
      },
      "Latitude": 0,
      "Longitude": 0
    },
    "IsAlias": true,
    "ParentCity": {
      "Key": "Key",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "SupplementalAdminAreas": [
      {
        "Level": 0,
        "LocalizedName": "LocalizedName",
        "EnglishName": "EnglishName"
      }
    ],
    "DataSets": [
      "string"
    ],
    "Details": {
      "Key": "Key",
      "StationCode": "StationCode",
      "StationGmtOffset": 0,
      "BandMap": "BandMap",
      "Climo": "Climo",
      "LocalRadar": "LocalRadar",
      "MediaRegion": "MediaRegion",
      "Metar": "Metar",
      "NXMetro": "NXMetro",
      "NXState": "NXState",
      "Population": 0,
      "PrimaryWarningCountyCode": "PrimaryWarningCountyCode",
      "PrimaryWarningZoneCode": "PrimaryWarningZoneCode",
      "Satellite": "Satellite",
      "Synoptic": "Synoptic",
      "MarineStation": "MarineStation",
      "MarineStationGMTOffset": 0,
      "VideoCode": "VideoCode",
      "LocationStem": "LocationStem",
      "DMA": {
        "ID": "ID",
        "EnglishName": "EnglishName"
      },
      "PartnerID": {},
      "Sources": [
        {
          "DataType": "DataType",
          "Source": "Source",
          "SourceId": 0,
          "PartnerSourceUrl": {}
        }
      ],
      "CanonicalPostalCode": "CanonicalPostalCode",
      "CanonicalLocationKey": "CanonicalLocationKey"
    },
    "EnglishName": "EnglishName",
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]

json

application/json

Top 150 cities list

GET

https://dataservice.accuweather.com

/locations/v1/topcities/150

Returns location data for the top 150 cities, worldwide

Top 150 cities list › query Parameters

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

format

string

A string value that specifies what type of format to provide the response.

Default: json

Top 150 cities list › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top 150 cities list › Responses

object[]

PrimaryPostalCode

string · minLength: 1 · required

Official postal code provided by our main location data provider for the requested location

object · required

IsAlias

boolean · required

“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location

object[] · required

The object containing a list of administrative area details

DataSets

string[] · required

EnglishName

string · minLength: 1 · required

Location name as displayed in English

Version

integer · int32 · required

Current version of the API

Key

string · minLength: 1 · required

Unique ID to search a location

Type

string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank

integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName

string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required

object

GET/locations/v1/topcities/150

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/topcities/150 \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "PrimaryPostalCode": "PrimaryPostalCode",
    "Region": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "TimeZone": {
      "Code": "Code",
      "NextOffsetChange": "2024-08-25T15:00:00Z",
      "Name": "Name",
      "GmtOffset": 0,
      "IsDaylightSaving": true
    },
    "GeoPosition": {
      "Elevation": {
        "Metric": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        },
        "Imperial": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        }
      },
      "Latitude": 0,
      "Longitude": 0
    },
    "IsAlias": true,
    "ParentCity": {
      "Key": "Key",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "SupplementalAdminAreas": [
      {
        "Level": 0,
        "LocalizedName": "LocalizedName",
        "EnglishName": "EnglishName"
      }
    ],
    "DataSets": [
      "string"
    ],
    "Details": {
      "Key": "Key",
      "StationCode": "StationCode",
      "StationGmtOffset": 0,
      "BandMap": "BandMap",
      "Climo": "Climo",
      "LocalRadar": "LocalRadar",
      "MediaRegion": "MediaRegion",
      "Metar": "Metar",
      "NXMetro": "NXMetro",
      "NXState": "NXState",
      "Population": 0,
      "PrimaryWarningCountyCode": "PrimaryWarningCountyCode",
      "PrimaryWarningZoneCode": "PrimaryWarningZoneCode",
      "Satellite": "Satellite",
      "Synoptic": "Synoptic",
      "MarineStation": "MarineStation",
      "MarineStationGMTOffset": 0,
      "VideoCode": "VideoCode",
      "LocationStem": "LocationStem",
      "DMA": {
        "ID": "ID",
        "EnglishName": "EnglishName"
      },
      "PartnerID": {},
      "Sources": [
        {
          "DataType": "DataType",
          "Source": "Source",
          "SourceId": 0,
          "PartnerSourceUrl": {}
        }
      ],
      "CanonicalPostalCode": "CanonicalPostalCode",
      "CanonicalLocationKey": "CanonicalLocationKey"
    },
    "EnglishName": "EnglishName",
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]

json

application/json

Top cities list by region

GET

https://dataservice.accuweather.com

/locations/v1/topcities/regions/{regionCode}

Returns location data for the top cities within a specific region

Top cities list by region › path Parameters

regionCode

string

A unique ID that designates a specific region. More information can be found here.

Example: NAM

Top cities list by region › query Parameters

languageID

integer · int32

A unique ID that designates a specific language.

Default: 1

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

Top cities list by region › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top cities list by region › Responses

object[]

PrimaryPostalCode

string · minLength: 1 · required

Official postal code provided by our main location data provider for the requested location

object · required

IsAlias

boolean · required

“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location

object[] · required

The object containing a list of administrative area details

DataSets

string[] · required

EnglishName

string · minLength: 1 · required

Location name as displayed in English

Version

integer · int32 · required

Current version of the API

Key

string · minLength: 1 · required

Unique ID to search a location

Type

string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank

integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName

string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required

object

GET/locations/v1/topcities/regions/{regionCode}

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/topcities/regions/:regionCode \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "PrimaryPostalCode": "PrimaryPostalCode",
    "Region": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "TimeZone": {
      "Code": "Code",
      "NextOffsetChange": "2024-08-25T15:00:00Z",
      "Name": "Name",
      "GmtOffset": 0,
      "IsDaylightSaving": true
    },
    "GeoPosition": {
      "Elevation": {
        "Metric": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        },
        "Imperial": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        }
      },
      "Latitude": 0,
      "Longitude": 0
    },
    "IsAlias": true,
    "ParentCity": {
      "Key": "Key",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "SupplementalAdminAreas": [
      {
        "Level": 0,
        "LocalizedName": "LocalizedName",
        "EnglishName": "EnglishName"
      }
    ],
    "DataSets": [
      "string"
    ],
    "Details": {
      "Key": "Key",
      "StationCode": "StationCode",
      "StationGmtOffset": 0,
      "BandMap": "BandMap",
      "Climo": "Climo",
      "LocalRadar": "LocalRadar",
      "MediaRegion": "MediaRegion",
      "Metar": "Metar",
      "NXMetro": "NXMetro",
      "NXState": "NXState",
      "Population": 0,
      "PrimaryWarningCountyCode": "PrimaryWarningCountyCode",
      "PrimaryWarningZoneCode": "PrimaryWarningZoneCode",
      "Satellite": "Satellite",
      "Synoptic": "Synoptic",
      "MarineStation": "MarineStation",
      "MarineStationGMTOffset": 0,
      "VideoCode": "VideoCode",
      "LocationStem": "LocationStem",
      "DMA": {
        "ID": "ID",
        "EnglishName": "EnglishName"
      },
      "PartnerID": {},
      "Sources": [
        {
          "DataType": "DataType",
          "Source": "Source",
          "SourceId": 0,
          "PartnerSourceUrl": {}
        }
      ],
      "CanonicalPostalCode": "CanonicalPostalCode",
      "CanonicalLocationKey": "CanonicalLocationKey"
    },
    "EnglishName": "EnglishName",
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]

json

application/json

Countries list by region code

GET

https://dataservice.accuweather.com

/locations/v1/countries/{regionCode}

Specify a region code to return a list of countries within that region.

Countries list by region code › path Parameters

regionCode

string

A unique ID that designates a specific region. More information can be found here.

Example: NAM

Countries list by region code › query Parameters

countryCode

string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

offset

integer · int32

A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.

Default: -1

format

string

A string value that specifies what type of format to provide the response.

Default: json

Countries list by region code › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Countries list by region code › Responses

object[]

ID

string · minLength: 1 · required

Unique administrative area ID

LocalizedName

string · minLength: 1 · required

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

string · minLength: 1 · required

Administrative area name displayed in English

GET/locations/v1/countries/{regionCode}

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/countries/:regionCode \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "ID": "ID",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName"
  }
]

json

application/json

Countries list

GET

https://dataservice.accuweather.com

/locations/v1/countries

This endpoint returns a list of available countries.

Countries list › query Parameters

regionCode

string

A unique ID that designates a specific region. More information can be found here.

Example: NAM

countryCode

string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

offset

integer · int32

A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.

Default: -1

format

string

A string value that specifies what type of format to provide the response.

Default: json

Countries list › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Countries list › Responses

object[]

ID

string · minLength: 1 · required

Unique administrative area ID

LocalizedName

string · minLength: 1 · required

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

string · minLength: 1 · required

Administrative area name displayed in English

GET/locations/v1/countries

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/countries \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "ID": "ID",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName"
  }
]

json

application/json

Region list

GET

https://dataservice.accuweather.com

/locations/v1/regions

List of all available regions

Region list › query Parameters

regionCode

string

A unique ID that designates a specific region. More information can be found here.

Example: NAM

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

format

string

A string value that specifies what type of format to provide the response.

Default: json

Region list › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Region list › Responses

object[]

ID

string · minLength: 1 · required

Unique administrative area ID

LocalizedName

string · minLength: 1 · required

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

string · minLength: 1 · required

Administrative area name displayed in English

GET/locations/v1/regions

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/regions \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "ID": "ID",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName"
  }
]

json

application/json

Country by region code and country code

GET

https://dataservice.accuweather.com

/locations/v1/countries/{regionCode}/{countryCode}

Specify a region code and a country code to return basic information about a country.

Country by region code and country code › path Parameters

regionCode

string · required

A unique ID that designates a specific region. More information can be found here.

countryCode

string · required

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Country by region code and country code › query Parameters

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

format

string

A string value that specifies what type of format to provide the response.

Default: json

Country by region code and country code › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Country by region code and country code › Responses

ID

string · minLength: 1 · required

Unique administrative area ID

LocalizedName

string · minLength: 1 · required

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

string · minLength: 1 · required

Administrative area name displayed in English

GET/locations/v1/countries/{regionCode}/{countryCode}

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/countries/:regionCode/:countryCode \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

{
  "ID": "ID",
  "LocalizedName": "LocalizedName",
  "EnglishName": "EnglishName"
}

json

application/json

Administrative area list by country code

GET

https://dataservice.accuweather.com

/locations/v1/adminareas/{countryCode}

Provide a country code to return basic information about administrative areas in the specified country

Administrative area list by country code › path Parameters

countryCode

string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

Administrative area list by country code › query Parameters

adminCode

string

A unique ID that designates a specific administrative area. More information can be found here.

Example: NY

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

offset

integer · int32

A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.

Default: -1

format

string

A string value that specifies what type of format to provide the response.

Default: json

Administrative area list by country code › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Administrative area list by country code › Responses

object[]

Level

integer · int64 · required

An assigned number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease. Numbers of 10 or greater are reserved for non-political boundaries and should be used independently

CountryID

string · minLength: 1 · required

Unique ISO or Microsoft Localization Code for the country that contains the AdministrativeArea.

ID

string · minLength: 1 · required

Unique administrative area ID

LocalizedName

string · minLength: 1 · required

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

string · minLength: 1 · required

Administrative area name displayed in English

LocalizedType

string | null

Administrative Area type displayed in the local dialect set with the language code in the URL. Default is US English (en-us).

EnglishType

string | null

Administrative Area type displayed in English.

GET/locations/v1/adminareas/{countryCode}

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/adminareas/:countryCode \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "Level": 0,
    "LocalizedType": {},
    "EnglishType": {},
    "CountryID": "CountryID",
    "ID": "ID",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName"
  }
]

json

application/json

Administrative area list

GET

https://dataservice.accuweather.com

/locations/v1/adminareas

Returns basic information about global administrative areas

Administrative area list › query Parameters

countryCode

string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

adminCode

string

A unique ID that designates a specific administrative area. More information can be found here.

Example: NY

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

offset

integer · int32

A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.

Default: -1

format

string

A string value that specifies what type of format to provide the response.

Default: json

Administrative area list › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Administrative area list › Responses

object[]

Level

integer · int64 · required

CountryID

string · minLength: 1 · required

Unique ISO or Microsoft Localization Code for the country that contains the AdministrativeArea.

ID

string · minLength: 1 · required

Unique administrative area ID

LocalizedName

string · minLength: 1 · required

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

string · minLength: 1 · required

Administrative area name displayed in English

LocalizedType

string | null

Administrative Area type displayed in the local dialect set with the language code in the URL. Default is US English (en-us).

EnglishType

string | null

Administrative Area type displayed in English.

GET/locations/v1/adminareas

curl --request GET \
  --url https://dataservice.accuweather.com/locations/v1/adminareas \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "Level": 0,
    "LocalizedType": {},
    "EnglishType": {},
    "CountryID": "CountryID",
    "ID": "ID",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName"
  }
]

json

application/json

Location Key Autocomplete