// the find
amadeus4dev/amadeus-java
Java library for the Amadeus Self-Service travel APIs
Official Java SDK for Amadeus's travel APIs — flights, hotels, transfers, points of interest, and a handful of ML-flavored prediction endpoints. It's for backend Java developers building travel booking or search features who need access to GDS/airline data without implementing OAuth and pagination themselves.
The fluent builder API maps directly to REST paths (`amadeus.shopping.flightOffersSearch.get(...)`) so you can read the Amadeus API docs and immediately know what Java call to make. Pagination is handled at the SDK level via `.next()` / `.previous()` rather than making you manage cursor params manually. Exception hierarchy is typed — `AuthenticationException`, `NotFoundException`, etc. — so callers can handle failure cases distinctly. Auto-initialization from environment variables means CI and production deployments don't need code changes.
The `Params.with(...).and(...)` chaining builds what is essentially an untyped string map — no compile-time enforcement that you're passing required fields or valid values, so you won't catch a missing `departureDate` until runtime. The SDK still requires Java 1.7 compatibility, which has kept the API design firmly pre-modern: no `CompletableFuture`, no reactive streams, every call is synchronous and blocking. Gson is a required external dependency rather than being shaded or optional, which can cause classpath conflicts in Spring Boot projects that prefer Jackson. The 110-star count and infrequent commit activity suggest Amadeus treats this as a compliance artifact rather than something they actively invest in.