FX & Currency

VanityPass exposes cached foreign exchange rates and currency conversion so your white-label app can price and display amounts in your users' preferred currency.

Key Endpoints

• Get rates — Fetch the latest cached FX rates
• Convert — Convert an amount from one currency to another
• Supported — List all currencies available for conversion

Rates are served from a periodically refreshed cache, so conversions stay fast and consistent across requests.

Authentication

Like all white-label endpoints, FX requests require:

• Authorization: Bearer <JWT> — Issued by your OAuth2 provider
• X-App-Id: <uuid> or X-App-Slug: <slug> — Identifies your white-label app
• X-Environment: Sandbox | Production — Route to the right environment

Use Cases

• Show fares and room rates in the user's home currency
• Convert amounts at checkout before payment
• Handle multi-currency billing in your app
• Display supported currencies in a settings picker