American Airlines
AAICAO: AALCallsign: AMERICAN
NDC Version21.3 / 24.1
AuthAccelya `<tc>` credential block in the SOAP header + gateway subscription key
HubDFW — Dallas/Fort Worth International
CoverageGlobal (350+ destinations)
Package
internal/adapters/americanairlines/Adapter Files
README.mddoc.goclient.gotypes_request.gotypes_response.goairshopping.goofferprice.goservicelist.goseatavailability.goordering.gomapper.gocabin.goroutemap.gopaxcache.goseatcache.goNDC Operations
11 of 11 operations implemented.
| Operation | Status |
|---|---|
| AirShopping | Live |
| OfferPrice | Live |
| ServiceList | Live |
| SeatAvailability | Live |
| OrderCreate | Live |
| OrderRetrieve | Live |
| OrderChange | Live |
| OrderCancel | Live |
| OrderReShop | Live |
| OrderCommit | Live |
| OrderQuote | Live |
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 |
Quirks & Gotchas
Known traps and special behaviours to be aware of when integrating with American Airlines:
- ⚠Not a direct AA endpoint — every operation goes through the Accelya (formerly Farelogix) Open Connect SOAP gateway.
- ⚠Single URL for everything; the operation is selected by the `SOAPAction` header (e.g. `IATA_AirShoppingRQ`).
- ⚠The SOAP body wrapper is literally `XXTransaction` — `XX` is not a carrier-code placeholder.
- ⚠Full `<tc>` credential block required (system + agent identity, PCC, IATA, dispatch script); a partial set fails with an opaque 'Invalid transaction control data' fault.
- ⚠`Agency` HTTP header must not contain spaces.
- ⚠COUNTRY_CODE must match the sales city Accelya registered against the PCC, or pricing fails with 'Inconsistent sales city and country'.
- ⚠OrderCreate can refuse codeshare segments inside connections ([126] Unable - Codeshare Flight); those offers are withheld unless explicitly enabled.
- ⚠Offer IDs are GUID-derived and opaque — no carrier prefix convention.
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…
Configuration
Environment variables used to configure the American Airlines adapter:
| Variable | Description | Default |
|---|---|---|
| AMERICAN_AIRLINES_BASE_URL | Accelya Open Connect gateway URL | — |
| AMERICAN_AIRLINES_SUBSCRIPTION_KEY | Ocp-Apim-Subscription-Key header | — |
| AMERICAN_AIRLINES_SYSTEM_USER | System identity (<iden u>) | — |
| AMERICAN_AIRLINES_SYSTEM_PASSWORD | System password (<iden p>) | — |
| AMERICAN_AIRLINES_AGENT_USER | Agent identity — defaults to SYSTEM_USER | — |
| AMERICAN_AIRLINES_AGENT_PASSWORD | Agent password — defaults to SYSTEM_PASSWORD | — |
| AMERICAN_AIRLINES_AGENT_ROLE | Agent role | Ticketing Agent |
| AMERICAN_AIRLINES_OFFICE_ID | PseudoCityCode (PCC) | — |
| AMERICAN_AIRLINES_AGENCY_IATA | Agency IATA number incl. check digit | — |
| AMERICAN_AIRLINES_AGENCY_NAME | Agency name (sent without spaces) | — |
| AMERICAN_AIRLINES_TRACE_ID | Trace ID for Accelya's trace console | — |
| AMERICAN_AIRLINES_DISPATCH_SCRIPT | FLXDM dispatch script name | — |
| AMERICAN_AIRLINES_COUNTRY_CODE | Point-of-sale country | ES |
| AMERICAN_AIRLINES_CITY_CODE | Optional point-of-sale city (IATA) | — |
| AMERICAN_AIRLINES_CURRENCY | Default currency | USD |
| AMERICAN_AIRLINES_NDC_VERSION | 21.3 or 24.1 | 21.3 |
| AMERICAN_AIRLINES_TIMEOUT | Request timeout | 45s |
| AMERICAN_AIRLINES_ALLOW_CODESHARE_CONNECTIONS | Sell codeshare connections | false |