B2B API

Welcome to the VanityPass B2B API documentation. These endpoints enable server-to-server integration using API key authentication. Build seamless integrations for hotel search, flight bookings, lounge access, ground transport, and more.

Quick Start

Get your test API key from the VanityPass dashboard, then make your first request:

curl -X GET https://cloud.vanitypass.com/v1/fx/rates \
  -H 'X-Api-Key: vp_test_abc123xyz' \
  -H 'X-Environment: Sandbox'

Expected response:

{
  "success": true,
  "data": {
    "rates": [
      { "from": "USD", "to": "EUR", "rate": 0.92 },
      { "from": "USD", "to": "GBP", "rate": 0.79 }
    ]
  }
}

Key Features

• Real-time availability: Search hotels, flights, lounges, and ground transport with instant supplier integration.
• AI-powered concierge: Use VanityPass AI to answer complex traveler questions and provide personalized recommendations.
• Perk management: Allocate, track, and redeem perks (lounge passes, hotel upgrades, etc.) across your membership programs.
• Sandbox testing: Full-featured sandbox for development and QA. No real charges.

Authentication

All requests require the X-Api-Key header:

X-Api-Key: vp_test_... (sandbox) | vp_live_... (production)
X-Environment: Sandbox | Production

Read Authentication Overview for details.

Popular Endpoints

• Search Hotels — Stream-based hotel availability with real-time updates.
• Book Ground Transport — Search and book ride services.
• Manage Perks — Allocate and track membership benefits.
• AI Concierge — Ask complex travel questions.

Explore by Category

• FX & Currency — Real-time exchange rates and currency conversion.
• Hotels — Search, book, and manage hotel reservations.
• Travel Services — Lounges, fast-track, dining, fitness, eSIM.
• Experiences — Tours, activities, attractions.
• Ground Transport — Ride booking and management.
• Partner Management — Manage apps, API keys, and billing.

Need help? Contact our API team.