White-label API

Welcome to the VanityPass White-label API documentation. These endpoints enable end-user applications to offer travel, hospitality, and membership services directly to your users. Authenticate with JWT tokens issued by your OAuth2 flow.

Quick Start

After your user logs in and receives a JWT token, use it to make requests:

curl -X GET https://cloud.vanitypass.com/v1/users/profile \
  -H 'Authorization: Bearer eyJhbGc...' \
  -H 'X-App-Id: 550e8400-e29b-41d4-a716-446655440000' \
  -H 'X-Environment: Sandbox'

Expected response:

{
  "success": true,
  "data": {
    "userId": "user123",
    "email": "user@example.com",
    "memberships": [
      { "id": "mem1", "tier": "Gold", "program": "MyBrand" }
    ]
  }
}

Key Features

• User authentication: JWT-based auth flow integrates with your existing login system.
• Personal bookings: Users manage their own hotel, flight, and experience bookings.
• Membership dashboard: Users view their tier, points, and available perks.
• Perk redemption: One-click redemption for lounge access, upgrades, and exclusive offers.
• Sandbox testing: Test user flows without real transactions.

Authentication

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

Read Authentication Overview for details.

Popular Endpoints

• User Profile — Get and update user info, membership, tier.
• Search Hotels — Let users browse and book hotels.
• Manage Bookings — Users view and cancel their bookings.
• Redeem Perks — Users claim lounge passes and offers.

Need help? Contact our API team.