Station

Stations are any Airport, Heliport, Seaplane Base, Gliderport, Weather Reporting Station, etc.

Stations are identified by a four-character alphanumeric ICAO code

 

Station Fields

The following table lists the fields which are returned by all Station endpoints.

Fields marked as Conditional will not be included in the JSON response data if no value exists for that field.

Therefore your code should check for the existence of these fields before attempting to access the data value to avoid any errors.

Field Type Description Conditional
icao string ICAO airport code or station indicator
name string Station name
activated string Activated Month/Year
city string City
country object Object with the following properties
.code string Country code abbreviation
.name string Country full text name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
elevation object Object with the following properties
.feet integer Elevation in feet
.meters integer Elevation in meters
.method string Method used to determine elevation - 'Surveyed' or 'Estimated'
iata string IATA airport code or station indicator
latitude object Object with the following properties
.decimal float Latitude in decimal degrees
.degrees string Latitude in degrees, minutes, seconds
longitude object Object with the following properties
.decimal float Longitude in decimal degrees
.degrees string Longitude in degrees, minutes, seconds
magnetic_variation object Object with the following properties
.position string The angle between magnetic north and true north
.year string Year of last magnetic variation determination
sectional string Station appears on this FAA Sectional chart (US/Canada)
state object Object with the following properties
.code string State/province abbreviation
.name string State/province full text name
status string Status - 'Operational' or 'Closed'
type string Type 'Airport', 'Heliport', 'Seaplane Base', etc.
useage string Useage 'Public', 'Private', 'Military', etc.
 

/station/:icao

Method
GET

Returns the latest Station information for a one or more ICAO codes.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request. Search for ICAO codes
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations
curl 'https://api.checkwx.com/station/KJFK,KLAX,KMIA' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/:icao/radius/:radius

Method
GET

Returns the latest Station information for stations within a specified radius of a single ICAO code.

The results are sorted based on the distance from the requested ICAO code.

Additional response fields are included in the response data to show the distance and direction from the requested ICAO parameter.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from string Base location ICAO
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
icao A single ICAO code. (Multiple ICAO codes are not allowed for this endpoint) Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK/radius/10' -H 'X-API-Key: YOUR_API_KEY'

###### single station with 'Airport' only filter
curl 'https://api.checkwx.com/station/KJFK/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/lat/:latitude/lon/:longitude

Method
GET

Returns the latest Station information for a single station nearest to the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude parameters.

Included in Plans
Basic
Yes
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


# latitude / longitude
curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99' -H 'X-API-Key: YOUR_API_KEY'

# latitude / longitude with 'Airport' only filter
curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/lat/:latitude/lon/:longitude/radius/:radius

Method
GET

Returns the latest Station information for multiple stations within a specified radius of the parameters latitude and longitude.

Additional response fields are included in the response data to show the distance and direction from the requested latitude and longitude parameters.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Additional Response Fields

Field Type Description
radius object Object with the following properties
.from.latitude float Base location latitude
.from.longitude float Base location longitude
.miles float Distance from base location in miles
.meters float Distance from base location in meters
.bearing integer Bearing from base location (0-360)
.direction string Compass text from base location (N/NE/E/SE/S/SW/W/NW)
Parameter Description
latitude The decimal latitude Required
longitude The decimal longitude Required
radius The surrounding radius in miles from the ICAO code.
250 miles is the maximum radius.
Required
Parameter Description
filter=A Filter the results by station type (A, H, G, S, W, O)

A = Airport
H = Heliport
G = Gliderport
S = Seaplane Base
W = Weather Station
O = Other
Optional
Parameter Description
X-API-Key Your unique API key Required

Example


curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99/radius/10' -H 'X-API-Key: YOUR_API_KEY'

curl 'https://api.checkwx.com/station/lat/40.72/lon/-73.99/radius/10?filter=A' -H 'X-API-Key: YOUR_API_KEY'

Try it Online

 

/station/:icao/timestamp

Method
GET

Returns the latest Station timestamp for one or more ICAO codes.

The time data includes both local (station) and UTC timezone formats, timezone ID, and offsets to GMT/DST

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Response Fields

Field Type Description
icao string ICAO airport code or station indicator
name string Station name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
timezone object Object with the following properties
.gmt signed integer Timezone offset subtracted or added to GMT time
.dst signed integer Timezone offset subtracted or added to GMT time including DST
.tzid string Timezone id text string
.zone string Timezone zone text string
timestamp object Object with the following properties
.local.current string Current local timestamp
.local.date string Local Date YYYY-MM-DD
.local.time string Local Time HH:MM:SS
.utc.current string Current UTC timestamp
.utc.date string UTC Date YYYY-MM-DD
.utc.time string UTC Time HH:MM:SS
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request.
Required
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK/timestamp' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations
curl 'https://api.checkwx.com/station/KJFK,KLAX/timestamp' -H 'X-API-Key: YOUR_API_KEY'

 

/station/:icao/suntimes

Method
GET

Returns the latest Station sunrise/sunset and dawn/dusk times for one or more ICAO codes.

The time data includes both local (station) and UTC timezone formats.

Included in Plans
Basic
No
Plus
Yes
Premium
Yes

Response Fields

Field Type Description
icao string ICAO airport code or station indicator
name string Station name
location GeoJSON GeoJSON location object
.coordinates array GeoJSON array of coordinates: [longitude, latitude]
.type string GeoJSON object type: "POINT"
timezone object Object with the following properties
.gmt signed integer Timezone offset subtracted or added to GMT time
.dst signed integer Timezone offset subtracted or added to GMT time including DST
.tzid string Timezone id text string
.zone string Timezone zone text string
sunrise_sunset object Object with the following properties
.local.sun_rise string Sunrise local HH:MM:SS
.local.sun_set string Sunset local HH:MM:SS
.local.civil_dawn string Civil dawn local HH:MM:SS
.local.civil_dusk string Civil dusk local HH:MM:SS
.utc.sun_rise string Sunrise GMT HH:MM:SS
.utc.sun_set string Sunset GMT HH:MM:SS
.utc.civil_dawn string Civil dawn GMT HH:MM:SS
.utc.civil_dusk string Civil dusk GMT HH:MM:SS
Parameter Description
icao A single ICAO code or multiple ICAO codes seperated by commas.
Maximum of 20 ICAO codes per request.
Parameter Description
X-API-Key Your unique API key Required

Example


###### single station
curl 'https://api.checkwx.com/station/KJFK/suntimes' -H 'X-API-Key: YOUR_API_KEY'

###### multiple stations
curl 'https://api.checkwx.com/station/KJFK,KLAX/suntimes' -H 'X-API-Key: YOUR_API_KEY'