Get Airport

GET

/api/v1/airports/{iata}

agent-data call bd63936c-8611-45a8-8ad8-083aa4c51aa9 get-airport --iata <iata>

Return current operational status for one airport.

Combines FAA NAS status (delays, ground stops, ground delay programs) with the most recent METAR weather observation. Reliability fields are placeholders until a vetted historical source is wired in.

Parameters

Path Parameters

iata

required

Iata

Specify the 3-letter IATA airport code to look up. The server normalizes the value to uppercase before validation and returns 404 if the code is not present in the built-in airport reference set.

string

Specify the 3-letter IATA airport code to look up. The server normalizes the value to uppercase before validation and returns 404 if the code is not present in the built-in airport reference set.

Responses

200

Successful Response

Media type application/json

Envelope[AirportStatusRecord]

object

data

required

AirportStatusRecord

object

city

Any of:

string

string

null

null

iata

required

Iata

string

icao

Any of:

string

string

null

null

name

required

Name

string

weather

required

AirportWeather

object

summary

Any of:

string

string

null

null

metar_raw

Any of:

string

string

null

null

ceiling_ft

Any of:

integer

integer

null

null

conditions

Conditions

Array<string>

wind_gust_kt

Any of:

integer

integer

null

null

temperature_c

Any of:

number

number

null

null

wind_speed_kt

Any of:

integer

integer

null

null

visibility_miles

Any of:

number

number

null

null

latitude

Any of:

number

number

null

null

timezone

Any of:

string

string

null

null

longitude

Any of:

number

number

null

null

conditions

required

AirportConditions

object

reason

Any of:

string

string

null

null

status

required

AirportConditionStatus

string

Allowed values: normal delays ground_stop ground_delay closed

updated_at

Any of:

string

string format: date-time

null

null

ground_stop

Ground Stop

boolean

ground_delay_program

Ground Delay Program

boolean

average_delay_minutes

Any of:

integer

integer

null

null

reliability

required

AirportReliability

object

data_period

Any of:

string

string

null

null

on_time_pct_30d

Any of:

number

number

null

null

avg_delay_minutes_30d

Any of:

integer

integer

null

null

cancellation_rate_30d

Any of:

number

number

null

null

country_code

Any of:

string

string

null

null

data_confidence

required

DataConfidence

string

Allowed values: high medium low

meta

required

ResponseMeta

object

cache

Any of:

CacheMetadata

CacheMetadata

object

hit

required

Hit

boolean

ttl_seconds

required

Ttl Seconds

integer

null

null

resource

required

Resource

string

returned

Any of:

integer

integer

null

null

request_id

Request Id

string

sources_used

Sources Used

Array<string>

total_results

Any of:

integer

integer

null

null

data_freshness

Any of:

string

string format: date-time

null

null

processing_time_ms

required

Processing Time Ms

integer

warnings

Warnings

Array<object>

WarningItem

object

code

required

Code

string

source

required

Source

string

message

required

Message

string

Example

{
  "data": {
    "conditions": {
      "status": "normal",
      "ground_stop": false,
      "ground_delay_program": false
    },
    "data_confidence": "high"
  }
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

Example ^generated

{
  "detail": [
    {
      "ctx": {},
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example"
    }
  ]
}