Catalog / American Airlines Public Data

American Airlines Public Data API

aa.com

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.

  • Other
  • airlines
  • flight-status
  • airports
  • travel
3 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

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

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=[].

1-4 digit flight number.

Optional parameters 2

Flight origin date in YYYY-MM-DD; defaults to today's UTC date.

Airline code accepted by AA's flight-status source; AA is the documented default.

View call pricing
cURL · Flight status
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 · string

1-4 digit flight number.

Example: 100

dateOptionalQuery · string (date) | null

Flight origin date in YYYY-MM-DD; defaults to today's UTC date.

Example: 2026-10-02

carrierOptionalQuery · string, default: AA

Airline code accepted by AA's flight-status source; AA is the documented default.

Example: AA

Response

datestring
foundboolean
carrierstring
flightsobject[]
flights[].codeShare?boolean | null
flights[].equipment?object
flights[].equipment.iataName?string | null
flights[].equipment.tailNumber?string | null
flights[].equipment.displayName?string | null
flights[].equipment.equipmentCode?string | null
flights[].airlineCode?string | null
flights[].arrivalInfo?object
flights[].arrivalInfo.gate?string | null
flights[].arrivalInfo.state?string | null
flights[].arrivalInfo.country?string | null
flights[].arrivalInfo.cityName?string | null
flights[].arrivalInfo.terminal?string | null
flights[].arrivalInfo.airportCode?string | null
flights[].arrivalInfo.actualInTime?string | null
flights[].arrivalInfo.actualOnTime?string | null
flights[].arrivalInfo.baggageClaim?string | null
flights[].arrivalInfo.actualArrivalTime?string | null
flights[].arrivalInfo.estimatedArrivalTime?string | null
flights[].arrivalInfo.scheduledArrivalTime?string | null
flights[].dupDepStaNum?string | null
flights[].flightNumber?string | null
flights[].flightStatus?string | null
flights[].stopOverInfo?string | null
flights[].codeShareInfo?object
flights[].codeShareInfo.marketCode?string | null
flights[].codeShareInfo.operatedBy?string | null
flights[].codeShareInfo.regionalCarrier?string | null
flights[].codeShareInfo.marketingCarrier?string | null
flights[].codeShareInfo.operatedByIATACode?string | null
flights[].departureInfo?object
flights[].departureInfo.gate?string | null
flights[].departureInfo.state?string | null
flights[].departureInfo.country?string | null
flights[].departureInfo.cityName?string | null
flights[].departureInfo.terminal?string | null
flights[].departureInfo.airportCode?string | null
flights[].departureInfo.actualOffTime?string | null
flights[].departureInfo.actualOutTime?string | null
flights[].departureInfo.actualDepartureTime?string | null
flights[].departureInfo.estimatedBoardingTime?string | null
flights[].departureInfo.scheduledBoardingTime?string | null
flights[].departureInfo.estimatedDepartureTime?string | null
flights[].departureInfo.scheduledDepartureTime?string | null
flights[].legStatusInfo?object
flights[].legStatusInfo.arrStatus?string | null
flights[].legStatusInfo.depStatus?string | null
flights[].legStatusInfo.legStatus?string | null
flights[].legStatusInfo.arrStatusDescription?string | null
flights[].legStatusInfo.depStatusDescription?string | null
flights[].legStatusInfo.legStatusDescription?string | null
flights[].wifiAvailable?boolean | null
flights[].flightStatusKey?string | null
flights[].flightStatusInfo?object
flights[].flightStatusInfo.landed?boolean | null
flights[].flightStatusInfo.canceled?boolean | null
flights[].flightStatusInfo.diverted?boolean | null
flights[].flightStatusInfo.inFlight?boolean | null
flights[].flightStatusInfo.priorTakeoff?boolean | null
flights[].flightStatusInfo.flifoFlightStatusPrimary?string | null
flights[].flightStatusInfo.flifoFlightStatusSecondary?string | null
flights[].flightStatusInfo.flifoFlightStatusPrimaryColor?string | null
flights[].flightStatusInfo.flifoFlightStatusSecondaryColor?string | null
flights[].disruptionMessage?object
flights[].disruptionMessage.passengerMessage?object
flights[].disruptionMessage.passengerMessage.longMessage?string | null
flights[].disruptionMessage.passengerMessage.shortMessage?string | null
flights[].disruptionMessage.passengerMessage.rebookMessage?string | null
flights[].disruptionMessage.passengerMessage.mediumFullMessage?string | null
flights[].disruptionMessage.passengerMessage.mediumCondensedMessage?string | null
flights[].disruptionMessage.passengerMessage.shortAdditionalInfoMessage?string | null
flights[].disruptionMessage.teamMemberMessage?object
flights[].disruptionMessage.teamMemberMessage.longMessage?string | null
flights[].disruptionMessage.teamMemberMessage.shortMessage?string | null
flights[].fastWifiAvailable?boolean | null
flights[].flightStatusColor?string | null
flights[].flightStatusParam?string | null
flights[].powerPortAvailable?boolean | null
flights[].previousFlightInfo?object
flights[].previousFlightInfo.priorLegOriginDate?string | null
flights[].previousFlightInfo.priorLegFlightNumber?string | null
flight_numberstring

Fields 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_US

AA locale for country names. en_US is the documented default; other source-supported locales may be accepted.

Example: en_US

Response

countinteger
localestring
countriesobject[]
countries[].codestring
countries[].namestring

Don’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.