Bulk wait times (Enterprise)

Wait estimates for up to 50 airports in one request. Enterprise keys only.

Access: Enterprise only.

POST

https://flightqueue.com/api/v1/airports/bulk

Authorization

BearerAuth
optional
HTTP

ApiKeyAuth
optional
API key in header

Request body JSON required

codes
array of
string
required
IATA codes to look up. Invalid codes return a per-item error. Enterprise limit: 50 codes.

Returns

200

Success

JSON

success
boolean
required
data
object
required
- airports
  array of
  required
  Any of the following:
  object
  airportCode
  string
  required
  Three-letter IATA airport code, upper case.
  
  pattern: ^[A-Z]{3}$
  security
  object
  required
  estimatedMinutes
  number
  required
  range
  object
  required
  min
  number
  required
  Lowest estimated wait, in minutes.
  
  max
  number
  required
  Highest estimated wait, in minutes.
  
  checkIn
  object
  required
  estimatedMinutes
  number
  required
  range
  object
  required
  min
  number
  required
  Lowest estimated wait, in minutes.
  
  max
  number
  required
  Highest estimated wait, in minutes.
  
  immigration
  object
  required
  estimatedMinutes
  number
  required
  range
  object
  required
  min
  number
  required
  Lowest estimated wait, in minutes.
  
  max
  number
  required
  Highest estimated wait, in minutes.
  
  confidence
  number
  required
  Model confidence, 0 to 1.
  
  object
  airportCode
  string
  required
  The code as sent in the request.
  
  error
  string
  required
- total
  integer
  required
  maximum: 9007199254740991 · minimum: -9007199254740991
- timestamp
  string
  required
  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))$
}
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))$
}

400

Bad request

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.
}

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.
}