American Airlines Public Data API
Read-only live access to American Airlines flight status and the airport/country catalog exposed by aa.com. Source retrieval uses structured JSON over HTTP; HTML pages and captured files are never used to serve responses. Flight records preserve AA's current status, disruption, leg, location, aircraft, codeshare, and amenity fields.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the American Airlines Public Data API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/5a8cc375-4a2f-42a1-9825-a309504699fb/v1/flight-status' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY" \
--data-urlencode 'flight_number=100'Endpoints
Inputs and response fields for every endpoint in this API.
GETFlight status/v1/flight-status
Queries AA's live structured flight-status service. Date defaults to today's UTC date. The flights array contains every source record returned for the requested flight/date; no matches return found=false and flights=[].
Input
flight_numberRequiredQuery · string1-4 digit flight number.
Example: 100
dateOptionalQuery · string (date) | nullFlight origin date in YYYY-MM-DD; defaults to today's UTC date.
Example: 2026-10-02
carrierOptionalQuery · string, default: AAAirline code accepted by AA's flight-status source; AA is the documented default.
Example: AA
Response
datestringfoundbooleancarrierstringflightsobject[]flights[].codeShare?boolean | nullflights[].equipment?objectflights[].equipment.iataName?string | nullflights[].equipment.tailNumber?string | nullflights[].equipment.displayName?string | nullflights[].equipment.equipmentCode?string | nullflights[].airlineCode?string | nullflights[].arrivalInfo?objectflights[].arrivalInfo.gate?string | nullflights[].arrivalInfo.state?string | nullflights[].arrivalInfo.country?string | nullflights[].arrivalInfo.cityName?string | nullflights[].arrivalInfo.terminal?string | nullflights[].arrivalInfo.airportCode?string | nullflights[].arrivalInfo.actualInTime?string | nullflights[].arrivalInfo.actualOnTime?string | nullflights[].arrivalInfo.baggageClaim?string | nullflights[].arrivalInfo.actualArrivalTime?string | nullflights[].arrivalInfo.estimatedArrivalTime?string | nullflights[].arrivalInfo.scheduledArrivalTime?string | nullflights[].dupDepStaNum?string | nullflights[].flightNumber?string | nullflights[].flightStatus?string | nullflights[].stopOverInfo?string | nullflights[].codeShareInfo?objectflights[].codeShareInfo.marketCode?string | nullflights[].codeShareInfo.operatedBy?string | nullflights[].codeShareInfo.regionalCarrier?string | nullflights[].codeShareInfo.marketingCarrier?string | nullflights[].codeShareInfo.operatedByIATACode?string | nullflights[].departureInfo?objectflights[].departureInfo.gate?string | nullflights[].departureInfo.state?string | nullflights[].departureInfo.country?string | nullflights[].departureInfo.cityName?string | nullflights[].departureInfo.terminal?string | nullflights[].departureInfo.airportCode?string | nullflights[].departureInfo.actualOffTime?string | nullflights[].departureInfo.actualOutTime?string | nullflights[].departureInfo.actualDepartureTime?string | nullflights[].departureInfo.estimatedBoardingTime?string | nullflights[].departureInfo.scheduledBoardingTime?string | nullflights[].departureInfo.estimatedDepartureTime?string | nullflights[].departureInfo.scheduledDepartureTime?string | nullflights[].legStatusInfo?objectflights[].legStatusInfo.arrStatus?string | nullflights[].legStatusInfo.depStatus?string | nullflights[].legStatusInfo.legStatus?string | nullflights[].legStatusInfo.arrStatusDescription?string | nullflights[].legStatusInfo.depStatusDescription?string | nullflights[].legStatusInfo.legStatusDescription?string | nullflights[].wifiAvailable?boolean | nullflights[].flightStatusKey?string | nullflights[].flightStatusInfo?objectflights[].flightStatusInfo.landed?boolean | nullflights[].flightStatusInfo.canceled?boolean | nullflights[].flightStatusInfo.diverted?boolean | nullflights[].flightStatusInfo.inFlight?boolean | nullflights[].flightStatusInfo.priorTakeoff?boolean | nullflights[].flightStatusInfo.flifoFlightStatusPrimary?string | nullflights[].flightStatusInfo.flifoFlightStatusSecondary?string | nullflights[].flightStatusInfo.flifoFlightStatusPrimaryColor?string | nullflights[].flightStatusInfo.flifoFlightStatusSecondaryColor?string | nullflights[].disruptionMessage?objectflights[].disruptionMessage.passengerMessage?objectflights[].disruptionMessage.passengerMessage.longMessage?string | nullflights[].disruptionMessage.passengerMessage.shortMessage?string | nullflights[].disruptionMessage.passengerMessage.rebookMessage?string | nullflights[].disruptionMessage.passengerMessage.mediumFullMessage?string | nullflights[].disruptionMessage.passengerMessage.mediumCondensedMessage?string | nullflights[].disruptionMessage.passengerMessage.shortAdditionalInfoMessage?string | nullflights[].disruptionMessage.teamMemberMessage?objectflights[].disruptionMessage.teamMemberMessage.longMessage?string | nullflights[].disruptionMessage.teamMemberMessage.shortMessage?string | nullflights[].fastWifiAvailable?boolean | nullflights[].flightStatusColor?string | nullflights[].flightStatusParam?string | nullflights[].powerPortAvailable?boolean | nullflights[].previousFlightInfo?objectflights[].previousFlightInfo.priorLegOriginDate?string | nullflights[].previousFlightInfo.priorLegFlightNumber?string | nullflight_numberstringFields marked ? are optional.
GETAirports search/v1/airports/search
Searches AA's legacy airport lookup JSON route by partial airport name, city, or IATA code. AA controls matching and normalization; an accepted query with no matches returns an empty array.
Input
queryRequiredQuery · stringAirport name, city, or IATA code; passed through to AA.
Example: LAX
Response
countintegerquerystringairportsobject[]airports[].codestringairports[].namestringairports[].state_code?string | nullairports[].country_code?string | nullairports[].country_name?string | nullFields marked ? are optional.
GETCountries/v1/countries
Returns the complete array delivered by AA's /airport/countries JSON route for the requested locale. The source catalog is the observable AA airport/network country list; the endpoint does not independently label which entries are operated versus partner-served.
Input
localeOptionalQuery · string, default: en_USAA locale for country names. en_US is the documented default; other source-supported locales may be accepted.
Example: en_US
Response
countintegerlocalestringcountriesobject[]countries[].codestringcountries[].namestringDon’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.