American Airlines
AAICAO: AALCallsign: AMERICAN
Available in the sandbox with every sandbox API key. Production availability is announced per airline in the changelog.
NDC Version24.1
HubDFW — Dallas/Fort Worth International
CoverageGlobal (350+ destinations)
NDC Operations
11 of 11 operations supported.
| Operation | Status |
|---|---|
| AirShopping | Supported |
| OfferPrice | Supported |
| ServiceList | Supported |
| SeatAvailability | Supported |
| OrderCreate | Supported |
| OrderRetrieve | Supported |
| OrderChange | Supported |
| OrderCancel | Supported |
| OrderReShop | Supported |
| OrderCommit | Supported |
| OrderQuote | Supported |
Payment
What American Airlines takes in payment on a booking, and whether it can carry a 3-D Secure result. The production agreement (sections 9.5 and 26.2) states these per carrier, on the carrier’s own page — this is that statement for AA.
| Capability | What this carrier does |
|---|---|
| Forms of payment | Your agency's own card, sent as `payment.card` — `number`, `holder`, `expiry_month`, `expiry_year`, `brand`, and `cvv`, which is optional. Send an amount with no card and the order settles offline instead: the carrier receives an "other" form of payment whose remark carries your `method` string. Send neither card nor amount and the order is created unpaid — a hold that stands until the ticketing deadline in `expires_at`. |
| 3-D Secure | Not supported by this carrier's channel. A booking or change carrying `payment.authentication` is refused with `422` telling you to omit it — the tokens are never forwarded, and never dropped in silence. Leave the block out on AA. |
| Commercial cards | Norba claims no exemption on your behalf: there is no exemption field in the payment object, so whether a commercial card escapes a challenge is between your issuer and the carrier's acquirer. Since no cardholder is present on a server-to-server booking and no challenge can be shown, an agency card under a corporate payment process is the usual path here. |
| Surcharges | Card surcharges (OB fees) are not disclosed before booking on this carrier; a surcharge AA applies forms part of what the carrier charges. |
Fare Types
| Fare | Description |
|---|---|
| Basic Economy | Most restrictive main-cabin fare, no changes |
| Main Cabin | Standard economy |
| Premium Economy | Extra legroom, enhanced service |
| Business / Flagship | Premium cabins, long-haul Flagship service |
Notes for integrators
Behaviours you will meet through the API when selling American Airlines:
- ⚠Price before you book. `POST /v1/offers/price` mints a new offer id and only that id is accepted by `POST /v1/orders`; an id that came straight from the search is refused before the airline is called, with a message telling you to price it first. Offer ids are opaque — percent-encode them in a URL path and never parse them.
- ⚠Connections with a partner-operated leg are withheld from search results by default, because the carrier does not confirm them at booking; `POST /v1/orders` also refuses one you still hold from an older search. Non-stop codeshares (a single AA-numbered flight flown by a partner) and itineraries flown entirely by AA are unaffected, and the operating carrier is disclosed on every segment.
- ⚠Seats and ancillaries are sold inside `POST /v1/orders`, in the same call as the flight. Adding a paid seat to an existing order is not available for this carrier; ancillaries can be added afterwards with `PUT /v1/orders/{orderID}` (`action: ancillaries`) or `POST /v1/orders/{orderID}/commit`.
- ⚠An order created without `payment` is an unpaid hold that the carrier keeps until the ticketing deadline in `expires_at`. Pay it with `POST /v1/orders/{orderID}/commit`, or send `payment` at creation to book and ticket in one call.
- ⚠The carrier reassigns passenger ids when it creates the order: the `T1` you sent comes back as the carrier's own id, and every later call must use that value.
Route Network
Key destinations served by American Airlines:
- ✈Mainline hubs: DFW, CLT, ORD, PHL, PHX, MIA, LAX, JFK, LGA, DCA
- ✈Domestic US: comprehensive hub-and-spoke coverage plus Canada and the Caribbean
- ✈Latin America: MIA gateway — Mexico, Central & South America
- ✈Europe: LHR, CDG, AMS, FRA, MUC, MAD, BCN, FCO, ATH, DUB, ZRH…
- ✈Asia-Pacific: NRT, HND, ICN, DEL, SYD, AKL…