amadeus

1# Amadeus
2 
3## Purpose
4Search travel with Amadeus Self-Service APIs: flight offers with prices, airport/city autocomplete, hotel offers, cheapest dates. This connector covers search plus pricing: it returns offers and prices, but it does not book tickets. Use when the user wants to search flights or hotels.
5 
6## Tooling
7All commands go through `bin/amadeus.py`:
8 
9```bash
10bin/amadeus.py auth                                        # verify the token (test env)
11bin/amadeus.py locations --keyword "London"               # airport/city autocomplete
12bin/amadeus.py flight-offers --origin JFK --destination LHR --departure-date 2026-10-01 --return-date 2026-10-08
13bin/amadeus.py hotel-offers --hotel-ids HTPAR001 --check-in 2026-10-01 --check-out 2026-10-03
14bin/amadeus.py flight-dates --origin JFK --destination LHR --departure-date 2026-10-01 --duration 7
15```
16 
17Pass `--env prod` to any command to use production instead of the test sandbox (default `--env test`).
18 
19## Auth
20- Provider id: `amadeus` (credential is collected as `custom.amadeus`)
21- Collection: OAuth 2.0 client credentials via the secure credential flow (`credentials.request_api_access`); sign up at developers.amadeus.com and create an app to get an API Key + API Secret. The runtime exchanges them at `POST /v1/security/oauth2/token` and hands the CLI a fresh access token as a Bearer credential.
22- Allowed hosts: `test.api.amadeus.com`, `api.amadeus.com`
23- Status check: `bin/amadeus.py auth` (must return `"ok": true`)
24…