A simple exchange-rate API for internal systems and approved consumers. It returns current or cached exchange rates with provider/cache metadata in the response body.
Optional parameters: date=YYYY-MM-DD (not in the future) returns the stored historical rate for that day; force=1 refreshes a current rate from the providers and is ignored when date is present, because historical rates are immutable once stored.
convert_from — XE-compatible. Accepts multiple to currencies and an amount; returns a to[] array where each entry carries its own source/provider. Does not include last_error.
rate — single target currency only. Returns a flat rate plus last_error: the exact reason the self-hosted layer was skipped (host / port / connection error). Best for debugging reachability.
curl -i \ -H "Accept: application/json" \ -H "X-Global-Exchange-Rates-Token: YOUR_CONSUMER_API_KEY" \ "https://supporthub.qms-portal.aero/api/v1/convert_from?from=GBP&to=USD,EUR&amount=100"
The key is sent in the X-Global-Exchange-Rates-Token header so it never collides with the Authorization header, which a reverse-proxy Basic-auth gate (e.g. on staging) may require. A bearer token or Basic-auth password is also accepted where no such gate is in front of /api.