Amadeus Self-Service APIs - Developer Documentation

Comprehensive, human-readable documentation for building travel applications with the Amadeus Self-Service APIs.

🎯 Target Stack: Go / Rust Backend Development
Use Case: OTA (Online Travel Agency) platforms, B2B booking engines, flight IBE

Why This Documentation?

Amadeus offers official SDKs for Python, Node, Java, Ruby – but not for Go or Rust. This documentation provides:

• Go-friendly struct definitions for request/response payloads
• Direct HTTP/REST patterns (no SDK dependency)
• Production-ready error handling strategies
• Caching recommendations for high-performance backends

📚 Documentation

Getting Started

Document	Description
Index	Overview and navigation guide
Authentication	OAuth2 setup, token management, environment configuration
Rate Limits	Request quotas, throttling, best practices
Common Errors	Error codes, troubleshooting, handling strategies

Flight Booking Flow

The complete flow for searching, pricing, and booking flights:

Step	Document	Description
1	Flight Offers Search	Search for flight offers by origin, destination, dates
2	Flight Offers Price	Get final pricing with taxes and fees
3	Flight Create Orders	Create a booking (PNR)
4	Flight Order Management	Retrieve, modify, cancel bookings

Ancillary Services

Document	Description
SeatMap Display	Aircraft seat maps, seat selection
Branded Fares Upsell	Upsell to premium fare classes

Shopping & Inspiration

Document	Description
Flight Inspiration Search	"Where can I fly?" - destination ideas by budget
Flight Cheapest Date Search	Find cheapest travel dates
Flight Availabilities Search	Real-time seat availability

Flight Information

Document	Description
On-Demand Flight Status	Real-time flight tracking, delays, gates

Reference Data

Document	Description
Airport & City Search	IATA codes, airport lookup, autocomplete
Airline Code Lookup	Airline codes, names, logos

🔧 Quick Start

1. Get API Credentials

1. Register at developers.amadeus.com
2. Create an app to get your API Key and API Secret
3. Start with the Test Environment (free, limited data)

2. Authentication

curl -X POST "https://test.api.amadeus.com/v1/security/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_API_KEY&client_secret=YOUR_API_SECRET"

3. Your First Search

curl "https://test.api.amadeus.com/v2/shopping/flight-offers?originLocationCode=ZRH&destinationLocationCode=BCN&departureDate=2026-03-15&adults=1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

🌍 Environments

Environment	Base URL	Purpose
Test	https://test.api.amadeus.com	Development, limited cached data
Production	https://api.amadeus.com	Live data, paid usage

📊 API Coverage

This documentation covers the Flight APIs which are the core of any OTA platform:

• ✅ Flight Search & Booking (complete flow)
• ✅ Ancillaries (seats, branded fares)
• ✅ Shopping tools (inspiration, cheapest dates)
• ✅ Flight status & tracking
• ✅ Reference data (airports, airlines)

Coming soon:

• 🔜 Hotel Search & Booking
• 🔜 Transfer Services
• 🔜 Tours & Activities

🔗 Official Resources

• Amadeus Developer Portal
• API Reference (Swagger)
• SDKs - Python, Node, Java, Ruby, iOS, Android
• Postman Collection

📝 License

This documentation is provided for educational and development purposes. Amadeus API usage is subject to Amadeus Terms of Use.

---

Maintained by: @sersery88