aa.com APIwww.aa.com ↗
Get real-time American Airlines flight status, gate/terminal info, aircraft amenities, and airport search via 3 clean JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/df32c5ac-b62e-4b2d-a725-8d47ade6e261/get_flight_status?date=2026-03-04&flight_number=100' \ -H 'X-API-Key: $PARSE_API_KEY'
Get real-time flight status by flight number and date. Returns detailed information including departure/arrival times, gates, terminals, aircraft type, amenities (WiFi, power ports), and current status (on time, delayed, canceled, etc.).
| Param | Type | Description |
|---|---|---|
| date | string | Flight date in YYYY-MM-DD format. When omitted, defaults to today's date (UTC). |
| carrier | string | Airline code (e.g., 'AA' for American Airlines) |
| flight_numberrequired | string | Flight number (e.g., '100', '2345') |
{
"type": "object",
"fields": {
"date": "string, date queried in YYYY-MM-DD format",
"found": "boolean, whether any flights matched",
"carrier": "string, airline code used in the query",
"flights": "array of flight objects with status, departure, arrival, aircraft, amenities, codeshare, and leg_status details",
"flight_number": "string, flight number queried"
},
"sample": {
"data": {
"date": "2026-05-14",
"found": true,
"carrier": "AA",
"flights": [
{
"status": "On time",
"arrival": {
"city": "London",
"gate": "",
"state": null,
"country": "United Kingdom",
"terminal": "3",
"actual_time": null,
"airport_code": "LHR",
"baggage_claim": null,
"estimated_time": "2026-05-15T06:25:00.000+01:00",
"scheduled_time": "2026-05-15T06:25:00.000+01:00"
},
"aircraft": {
"code": "77W",
"type": "Boeing 777-300ER",
"tail_number": "7LF"
},
"amenities": {
"wifi": true,
"fast_wifi": false,
"power_ports": true
},
"codeshare": {
"operated_by": null,
"is_codeshare": false,
"marketing_carrier": "American Airlines"
},
"departure": {
"city": "New York",
"gate": "2",
"state": "NY",
"country": "United States",
"terminal": "8",
"actual_time": null,
"airport_code": "JFK",
"estimated_time": "2026-05-14T18:20:00.000-04:00",
"scheduled_time": "2026-05-14T18:20:00.000-04:00",
"estimated_boarding_time": "2026-05-14T17:30:00.000-04:00",
"scheduled_boarding_time": "2026-05-14T17:30:00.000-04:00"
},
"leg_status": {
"description": "NORMAL",
"arrival_status": "SCHEDULED",
"departure_status": "SCHEDULED"
},
"airline_code": "AA",
"status_color": "GREEN",
"flight_number": "100",
"status_detail": {
"landed": false,
"primary": "ON TIME",
"canceled": false,
"diverted": false,
"in_flight": false,
"secondary": ""
}
}
],
"flight_number": "100"
},
"status": "success"
}
}About the aa.com API
The American Airlines API exposes 3 endpoints covering live flight status, airport lookup, and country listings drawn from aa.com. The get_flight_status endpoint returns per-flight data including departure and arrival times, gate assignments, terminal, aircraft type, WiFi availability, and current delay or cancellation status. Pair it with search_airports to resolve IATA codes or city names before querying a specific flight.
Flight Status
The get_flight_status endpoint accepts a flight_number (required), an optional carrier code (e.g. AA), and an optional date in YYYY-MM-DD format — defaulting to today's UTC date when omitted. The response returns a flights array where each object carries departure and arrival details (times, gates, terminals), aircraft type, codeshare information, per-leg status, and an amenities block that flags features like WiFi and power ports. The top-level found boolean lets you quickly gate on whether any results matched before parsing the array.
Airport Search
The search_airports endpoint takes a free-text query — an IATA code like LAX, a city name like New York, or a partial airport name. It returns a count and an airports array where each entry includes the IATA code, full name, state_code, country_code, and country_name. This is useful for validating user input or building autocomplete for flight search flows before passing a carrier and flight number to the status endpoint.
Country Listings
The get_countries endpoint returns every country served by American Airlines airports. An optional locale parameter (e.g. en_US) controls the language of country names in the response. Each entry in the countries array has a code and a name, and the top-level count tells you how many countries were returned. This list reflects the actual geographic scope of the AA network at the time of the call.
- Display live departure/arrival times and gate info on a travel dashboard for AA flight numbers
- Alert travelers when a flight's status changes to delayed or canceled using the status field
- Build an airport autocomplete input that resolves city names and IATA codes via search_airports
- Show aircraft amenities (WiFi, power ports) to passengers before boarding using the amenities block
- Validate whether a given IATA code exists in the AA network before submitting a flight query
- Generate a list of all countries AA serves for route-planning or geographic filtering in a travel app
- Track codeshare flight details by inspecting the codeshare fields returned per flight object
| 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 | 250 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 American Airlines offer an official public developer API?+
What does get_flight_status return beyond basic departure and arrival times?+
flights array includes gate and terminal assignments for both origin and destination, aircraft type, a per-leg status (on time, delayed, canceled, etc.), codeshare partner details, and an amenities block indicating whether WiFi and power ports are available on that specific aircraft.Can I look up flights for carriers other than American Airlines?+
carrier parameter accepts airline codes other than AA, and the endpoint will attempt to return status for those flights where data is available. Coverage is centered on American Airlines-operated and codeshare flights. You can fork this API on Parse and revise it to add dedicated endpoints for other carriers or to normalize multi-carrier responses.Does the API return historical flight data or booking/fare information?+
How fresh is the flight status data, and is pagination supported for search_airports?+
search_airports response returns all matching airports in a single array with a count field; there is no cursor or page parameter. If you need paginated or batched airport results, you can fork the API on Parse and revise the endpoint to add that behavior.