# Finding Weather Stations

Many API endpoints require a weather station indentifier. Most weather stations are identified by their WMO ID. However, some weather stations may not be listed in the WMO index. Therefore, these weather stations are given five-digit IDs containing both numbers and letters.

# Endpoint

GET https://api.meteostat.net/v2/stations/search

# Parameters

Parameter Description Type Required Default
query The search string String Yes undefined
limit The maximum number of results Integer No 8

Alternatively, you can download a full list of all weather stations available via Meteostat in JSON format.

# Response

The response body includes the following properties.

Parameter Description Type
id The Meteostat ID of the weather station String
name Object containing the name of the weather stations in different languages Object
country ISO 3166-1 alpha-2 country code of the weather station String
region The ISO 3166-2 state or region code of the weather station String
national The national ID of the weather station String
wmo The WMO ID of the weather station Integer
icao The ICAO ID of the weather station String
iata The IATA ID of the weather station String
latitude The latitude of the weather station Float
longitude The longitude of the weather station Float
elevation The elevation of the weather station in meters above sea level Integer
timezone The time zone of the weather station String
active A boolean value which is true if the weather station reported data within the previous 90 days Boolean

# Example: Search results for “vancouver”

The following example shows search results for the term “vancouver”. It requires the cURL command-line interface. Alternatively, you can use an API client like Postman.

curl --header "x-api-key: {key}" "https://api.meteostat.net/v2/stations/search?query=vancouver"

Please replace {key} with your personal API key.

# Data Response

The request returns four results:

  • Vancouver Airport
  • West Vancouver
  • Vancouver / Officers Row
  • Vancouver

This is the JSON output:

{
    "meta": {
        "exec_time": 0.022,
        "generated": "2020-06-14 10:06:26"
    },
    "data": [
        {
            "id": "71892",
            "name": {
                "en": "Vancouver Airport"
            },
            "country": "CA",
            "region": "BC",
            "national": null,
            "wmo": "71892",
            "icao": "CYVR",
            "iata": null,
            "latitude": 49.1833,
            "longitude": -123.1667,
            "elevation": 3,
            "timezone": "America/Vancouver",
            "active": true
        },
        {
            "id": "71784",
            "name": {
                "en": "West Vancouver"
            },
            "country": "CA",
            "region": "BC",
            "national": null,
            "wmo": "71784",
            "icao": "CWWA",
            "iata": null,
            "latitude": 49.35,
            "longitude": -123.1833,
            "elevation": 178,
            "timezone": "America/Vancouver",
            "active": true
        },
        {
            "id": "KVUO0",
            "name": {
                "en": "Vancouver / Officers Row"
            },
            "country": "US",
            "region": "WA",
            "national": null,
            "wmo": null,
            "icao": "KVUO",
            "iata": null,
            "latitude": 45.6205,
            "longitude": -122.6565,
            "elevation": 9,
            "timezone": "America/Los_Angeles",
            "active": true
        },
        {
            "id": "71201",
            "name": {
                "en": "Vancouver"
            },
            "country": "CA",
            "region": "BC",
            "national": null,
            "wmo": "71201",
            "icao": "CWHC",
            "iata": null,
            "latitude": 49.3,
            "longitude": -123.1167,
            "elevation": 2,
            "timezone": "America/Vancouver",
            "active": true
        }
    ]
}
Last Updated: 10/28/2020, 10:39:57 AM