Saved Perks & Redemption

Saved perks are benefits pre-allocated to a user's membership — lounge passes, upgrade vouchers, dining credits, etc. Users activate and redeem them at the point of use.

Redemption Flow

1. GET /v1/perks/saved → list available perks
2. GET /v1/perks/saved/{id}/can-use → check eligibility
3. POST /v1/perks/saved/{id}/activate → mark as in-use
4. POST /v1/perks/saved/{id}/use → confirm redemption at venue

List Saved Perks

GET /v1/perks/saved

Returns all perks saved to the authenticated user's membership.

curl -X GET 'https://cloud.vanitypass.com/v1/perks/saved' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Get Saved Perk Details

GET /v1/perks/saved/{saved_perk_id}

curl -X GET 'https://cloud.vanitypass.com/v1/perks/saved/{saved_perk_id}' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Check If Perk Can Be Used

GET /v1/perks/saved/{saved_perk_id}/can-use

Returns eligibility — whether the perk is valid, not expired, and not already used.

curl -X GET 'https://cloud.vanitypass.com/v1/perks/saved/{saved_perk_id}/can-use' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Activate Perk

POST /v1/perks/saved/{saved_perk_id}/activate

Marks the perk as active. Call this when the user arrives at the venue and is about to redeem.

curl -X POST 'https://cloud.vanitypass.com/v1/perks/saved/{saved_perk_id}/activate' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Use Perk

POST /v1/perks/saved/{saved_perk_id}/use

Confirms redemption. Records the perk as used and deducts from the user's balance.

curl -X POST 'https://cloud.vanitypass.com/v1/perks/saved/{saved_perk_id}/use' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Acknowledge Perk

POST /v1/perks/saved/{saved_perk_id}/acknowledge

Marks the perk as seen/acknowledged by the user (e.g. after showing a notification).

curl -X POST 'https://cloud.vanitypass.com/v1/perks/saved/{saved_perk_id}/acknowledge' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Cancel Perk

POST /v1/perks/saved/{saved_perk_id}/cancel

Cancels an activated perk if the user changes their mind before using it.

curl -X POST 'https://cloud.vanitypass.com/v1/perks/saved/{saved_perk_id}/cancel' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Get Perks for a Booking

GET /v1/perks/saved/booking/{booking_id}

Returns perks associated with a specific hotel or travel booking.

curl -X GET 'https://cloud.vanitypass.com/v1/perks/saved/booking/{booking_id}' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \