Historical wait time patterns

Wait patterns by hour and day of week, built from the last 30 days of data on all plans. lookbackDays reports the plan label and does not change the window. The example shows a Pro response.

Access: Premium.

GET

https://flightqueue.com/api/v1/airports/{iata}/historical

Authorization

BearerAuth
optional
HTTP

ApiKeyAuth
optional
API key in header

Path parameters

iata
string
required
Three-letter IATA airport code.

pattern: ^[A-Za-z]{3}$

Returns

200

Success

JSON

success
boolean
required
data
required
Any of the following:
object
airportCode
string
required
Three-letter IATA airport code, upper case.

pattern: ^[A-Z]{3}$
lookbackDays
integer
required
maximum: 9007199254740991 · minimum: -9007199254740991
patterns
object
required
airportCode
string
required
Three-letter IATA airport code, upper case.

pattern: ^[A-Z]{3}$
patterns
array of
object
required
airportCode
string
required
Three-letter IATA airport code, upper case.

pattern: ^[A-Z]{3}$
dayOfWeek
integer
required
0 = Sunday.

maximum: 6 · minimum: 0
hourOfDay
integer
required
maximum: 23 · minimum: 0
avgSecurityWait
number
required
avgImmigrationWait
number
required
sampleCount
integer
required
maximum: 9007199254740991 · minimum: -9007199254740991
confidence
number
required
0 to 1, based on sample count.

lastUpdated
string
required
ISO 8601 timestamp in UTC.

format: date-time · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
overallAvgSecurity
number
required
overallAvgImmigration
number
required
totalSamples
integer
required
maximum: 9007199254740991 · minimum: -9007199254740991
peakHours
array of
integer
required
maximum: 9007199254740991 · minimum: -9007199254740991
quietHours
array of
integer
required
maximum: 9007199254740991 · minimum: -9007199254740991
lastUpdated
string
required
ISO 8601 timestamp in UTC.

format: date-time · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
object
airportCode
string
required
Three-letter IATA airport code, upper case.

pattern: ^[A-Z]{3}$
lookbackDays
integer
required
maximum: 9007199254740991 · minimum: -9007199254740991
patterns
array of
unknown
required
message
string
required
}
meta
object
required
- requestId
  string
  required
  Unique ID for this request. Quote it when you contact support.
  
  format: uuid · pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- timestamp
  string
  required
  ISO 8601 timestamp in UTC.
  
  format: date-time · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
}

401

Unauthorized

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}

403

Forbidden

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}

429

Too many requests

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}