API v1

API Documentation

Access FlightQueue airport intelligence programmatically. Integrate real-time wait times, delay data, and predictions into your travel management platform.

Quick Start

Base URL

https://api.flightqueue.com/v1

Example Request

cURL

curl -X GET "https://api.flightqueue.com/v1/airports/JFK/wait-times" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentication

All API requests require an API key passed in the Authorization header.

Header

Authorization: Bearer fq_live_xxxxxxxxxxxxxxxxxxxxxxxx

API keys are available on Enterprise plans. Contact sales for access.

Rate Limits

PLAN	REQUESTS/MIN	REQUESTS/DAY
Enterprise Starter	60	10,000
Enterprise Pro	300	100,000
Enterprise Custom	Custom	Unlimited

Rate limit headers are included in all responses: X-RateLimit-Remaining, X-RateLimit-Reset

Endpoints

GET/api/v1/airports/{iata}/wait-times

Get current security and passport control wait times for an airport.

Parameters

iatastringREQUIREDIATA airport code (e.g., JFK, LHR)

terminalstringFilter by terminal

Response

{
  "airport": "JFK",
  "timestamp": "2026-03-13T14:30:00Z",
  "security": {
    "average_wait_minutes": 18,
    "terminals": [
      { "terminal": "1", "wait_minutes": 22 },
      { "terminal": "4", "wait_minutes": 15 }
    ]
  },
  "passport_control": {
    "average_wait_minutes": 35
  }
}

GET/api/v1/airports/{iata}/delays

Get current FAA delay programs, ground stops, and disruption status.

Parameters

iatastringREQUIREDIATA airport code

Response

{
  "airport": "JFK",
  "timestamp": "2026-03-13T14:30:00Z",
  "status": "delays",
  "programs": [
    {
      "type": "ground_delay",
      "reason": "weather",
      "average_delay_minutes": 45,
      "start_time": "2026-03-13T12:00:00Z"
    }
  ]
}

GET/api/v1/airports/{iata}/predictions

Get predicted wait times for the next 24 hours based on historical data and ML models.

Parameters

iatastringREQUIREDIATA airport code

datestringDate in YYYY-MM-DD format (default: today)

Response

{
  "airport": "JFK",
  "date": "2026-03-13",
  "predictions": [
    { "hour": 6, "predicted_wait_minutes": 8 },
    { "hour": 7, "predicted_wait_minutes": 15 },
    { "hour": 8, "predicted_wait_minutes": 25 },
    { "hour": 9, "predicted_wait_minutes": 22 }
  ],
  "confidence": 0.87
}

GET/api/v1/airports

List all supported airports with their current status overview.

Parameters

countrystringFilter by ISO country code

limitnumberMax results (default: 50, max: 200)

Response

{
  "airports": [
    {
      "iata": "JFK",
      "name": "John F. Kennedy International",
      "city": "New York",
      "country": "US",
      "has_wait_times": true,
      "has_delays": true
    }
  ],
  "total": 523,
  "page": 1
}

Error Codes

CODE	DESCRIPTION
`401`	Invalid or missing API key
`403`	API key does not have access to this resource
`404`	Airport or resource not found
`429`	Rate limit exceeded
`500`	Internal server error

Get API Access

API access is available on Enterprise plans. Contact our sales team to get started with a custom integration.

Contact Sales View Enterprise Plans