VANITYPASS
B2B API

Environments

Understand sandbox vs production and the X-Environment header.

Environments

VanityPass operates two isolated environments: Sandbox for development and testing, and Production for live transactions.

Sandbox

The sandbox environment is a complete replica of the production system where you can:

  • Test all API endpoints without real charges
  • Create test bookings and reservations
  • Verify workflow integration
  • Experiment with error handling

Endpoint: https://cloud.vanitypass.com Header: X-Environment: Sandbox

Use sandbox API keys (vp_test_*) to authenticate. These keys are valid only in the sandbox environment.

Production

Production is the live environment where real transactions occur and real charges are applied.

Endpoint: https://cloud.vanitypass.com (same domain, different schema) Header: X-Environment: Production

Use production API keys (vp_live_*) to authenticate. Production access requires approval and signed contract.

Playground Policy

This documentation site's interactive "Try it" playground is sandbox-only. Every request is automatically routed to:

https://cloud.vanitypass.com
X-Environment: Sandbox

To test against production or to get production API keys, contact the sales team.

Header Examples

Sandbox request

GET /v1/fx/rates
Host: cloud.vanitypass.com
X-Api-Key: vp_test_abc123
X-Environment: Sandbox

Production request

GET /v1/fx/rates
Host: cloud.vanitypass.com
X-Api-Key: vp_live_xyz789
X-Environment: Production

Omitting the X-Environment header defaults to Production.