JFK Airport APIjfkairport.com ↗
Real-time security checkpoint and customs wait times for all JFK terminals. Get TSA PreCheck and general queue durations per terminal via a single endpoint.
What is the JFK Airport API?
The JFK Airport API exposes 1 endpoint, get_wait_times, that returns live security and customs queue durations for every open terminal at John F. Kennedy International Airport. Each response includes per-terminal records covering general security lanes, TSA PreCheck lanes, and customs visitor queues where applicable — all reported in minutes and reflecting current checkpoint conditions.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/cd63e7e6-ec31-438b-9445-43f8bded72da/get_wait_times' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jfkairport-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: JFK Airport wait times SDK — bounded, re-runnable."""
from parse_apis.jfkairport_com_api import JFK, ParseError
client = JFK()
# List current wait times for all terminals
for terminal in client.terminals.list(limit=3):
print(terminal.terminal, "| General:", terminal.security_general_wait_minutes, "min",
"| TSA Pre:", terminal.security_tsa_precheck_wait_minutes, "min",
"| Customs:", terminal.customs_visitors_wait_minutes, "min")
# Get the first terminal's details
first = client.terminals.list(limit=1).first()
try:
print(f"\n{first.terminal} last updated: {first.last_updated}")
print(f" Security open: {first.security_general_is_open}")
except ParseError as e:
print("error:", e)
print("exercised: terminals.list")
Returns current real-time security checkpoint and customs wait times for every open terminal at JFK. Each terminal reports general and TSA PreCheck security queue durations (in minutes) and, where available, customs visitor queue duration. Wait times are calculated from checkpoint queue entry and updated continuously; the last_updated timestamp reflects the most recent measurement.
No input parameters required.
{
"type": "object",
"fields": {
"terminals": "array of per-terminal wait time records"
},
"sample": {
"terminals": [
{
"terminal": "Terminal 1",
"last_updated": "7:24 PM",
"terminal_number": "1",
"customs_visitors_is_open": null,
"security_general_is_open": true,
"customs_visitors_wait_minutes": null,
"security_general_wait_minutes": 12,
"security_tsa_precheck_is_open": true,
"security_tsa_precheck_wait_minutes": 7
},
{
"terminal": "Terminal 4",
"last_updated": "7:23 PM",
"terminal_number": "4",
"customs_visitors_is_open": true,
"security_general_is_open": true,
"customs_visitors_wait_minutes": 1,
"security_general_wait_minutes": 22,
"security_tsa_precheck_is_open": true,
"security_tsa_precheck_wait_minutes": 5
}
]
}
}About the JFK Airport API
What the API Returns
The get_wait_times endpoint returns a terminals array where each element represents one open terminal at JFK. Each record includes the terminal identifier, the current wait time (in minutes) for the standard security checkpoint lane, and the current wait time for the TSA PreCheck lane. For international terminals that process arriving passengers, a customs visitor queue duration is also included when data is available.
Endpoint Behavior
GET get_wait_times takes no input parameters — a single call retrieves the full picture across all terminals simultaneously. There is no need to query terminals individually. If a terminal is closed or a specific lane type is not operating, that field is either absent or marked accordingly in the response.
Coverage and Freshness
Wait times reflect real-time conditions as reported for JFK's terminals. The data is useful for pre-trip planning, airport operations dashboards, or traveler-facing apps that want to surface checkpoint conditions before passengers arrive at the airport. Because the endpoint requires no filtering parameters, integrating it into a polling loop is straightforward — just call it on a schedule and diff the terminals array between responses to detect changes.
The JFK Airport API is a managed, monitored endpoint for jfkairport.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jfkairport.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jfkairport.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display live TSA PreCheck vs. general lane wait times in a travel app before departure
- Alert travelers via SMS or push notification when security wait times exceed a threshold
- Build an airport operations dashboard tracking checkpoint congestion across all JFK terminals
- Compare customs wait times across international terminals to advise arriving passengers on gate routing
- Log historical wait time trends by terminal for analysis of peak congestion periods
- Power a browser extension that shows current JFK queue times during flight search or booking
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does jfkairport.com have an official developer API?+
What does get_wait_times return for each terminal?+
terminals array includes the terminal identifier, the general security checkpoint wait time in minutes, the TSA PreCheck lane wait time in minutes, and — for terminals handling international arrivals — a customs visitor queue duration where the source reports one.