Hourly wait time predictions

Hourly security wait forecasts. Pro keys receive 24 hours from the start time. Enterprise keys receive 168 hours. The example shows a Pro response.

Access: Premium; up to 24h (Pro) or 7 days (Enterprise).

GET

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

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

Query parameters

date
optional
string
Start date, YYYY-MM-DD. Defaults to now. Pro returns 24 hours, Enterprise returns 168 hours.

pattern: ^\d{4}-\d{2}-\d{2}$

Returns

200

Success

JSON

success
boolean
required
data
object
required
- airportCode
  string
  required
  Three-letter IATA airport code, upper case.
  
  pattern: ^[A-Z]{3}$
- predictions
  array of
  object
  required
  hour
  integer
  required
  Hour offset from the start time.
  
  maximum: 9007199254740991 · minimum: -9007199254740991
  waitMinutes
  number
  required
  confidence
  number
  required
- bestTime
  object
  required
  hour
  integer
  required
  maximum: 9007199254740991 · minimum: -9007199254740991
  waitMinutes
  number
  required
- worstTime
  object
  required
  hour
  integer
  required
  maximum: 9007199254740991 · minimum: -9007199254740991
  waitMinutes
  number
  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))$
}

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

Hourly wait time predictions

curl --request GET \
  --url 'https://flightqueue.com/api/v1/airports/<iata>/predictions' \
  --header 'Authorization: Bearer <token>'

const url = 'https://flightqueue.com/api/v1/airports/<iata>/predictions';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response example

{
  "success": true,
  "data": {
    "airportCode": "JFK",
    "predictions": [
      {
        "hour": 0,
        "waitMinutes": 20,
        "confidence": 0.8
      },
      {
        "hour": 1,
        "waitMinutes": 24,
        "confidence": 0.8
      },
      {
        "hour": 2,
        "waitMinutes": 28,
        "confidence": 0.8
      },
      {
        "hour": 3,
        "waitMinutes": 32,
        "confidence": 0.8
      },
      {
        "hour": 4,
        "waitMinutes": 36,
        "confidence": 0.8
      },
      {
        "hour": 5,
        "waitMinutes": 40,
        "confidence": 0.8
      },
      {
        "hour": 6,
        "waitMinutes": 20,
        "confidence": 0.8
      },
      {
        "hour": 7,
        "waitMinutes": 24,
        "confidence": 0.8
      },
      {
        "hour": 8,
        "waitMinutes": 28,
        "confidence": 0.8
      },
      {
        "hour": 9,
        "waitMinutes": 32,
        "confidence": 0.8
      },
      {
        "hour": 10,
        "waitMinutes": 36,
        "confidence": 0.8
      },
      {
        "hour": 11,
        "waitMinutes": 40,
        "confidence": 0.8
      },
      {
        "hour": 12,
        "waitMinutes": 20,
        "confidence": 0.8
      },
      {
        "hour": 13,
        "waitMinutes": 24,
        "confidence": 0.8
      },
      {
        "hour": 14,
        "waitMinutes": 28,
        "confidence": 0.8
      },
      {
        "hour": 15,
        "waitMinutes": 32,
        "confidence": 0.8
      },
      {
        "hour": 16,
        "waitMinutes": 36,
        "confidence": 0.8
      },
      {
        "hour": 17,
        "waitMinutes": 40,
        "confidence": 0.8
      },
      {
        "hour": 18,
        "waitMinutes": 20,
        "confidence": 0.8
      },
      {
        "hour": 19,
        "waitMinutes": 24,
        "confidence": 0.8
      },
      {
        "hour": 20,
        "waitMinutes": 28,
        "confidence": 0.8
      },
      {
        "hour": 21,
        "waitMinutes": 32,
        "confidence": 0.8
      },
      {
        "hour": 22,
        "waitMinutes": 36,
        "confidence": 0.8
      },
      {
        "hour": 23,
        "waitMinutes": 40,
        "confidence": 0.8
      }
    ],
    "bestTime": {
      "hour": 0,
      "waitMinutes": 20
    },
    "worstTime": {
      "hour": 23,
      "waitMinutes": 40
    }
  },
  "meta": {
    "requestId": "3f8c2b1e-6d4a-4f7b-9a1e-2c5d8e7f0a12",
    "timestamp": "2026-11-07T12:00:00.000Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_DATE",
    "message": "The date parameter is not a valid YYYY-MM-DD date."
  }
}

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "No API key was sent in X-API-Key or Authorization."
  }
}

{
  "success": false,
  "error": {
    "code": "PREMIUM_REQUIRED",
    "message": "The key does not include the premium feature for this endpoint."
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "The key sent more requests per minute than its tier allows."
  }
}