Perk Inventory

Perk counts describe how many perks the user currently holds, broken down by product type (for example lounge, meet-and-greet, or fast-track products). Use these endpoints to render a wallet or entitlement screen and to track how a user's inventory changes over time.

All requests are authenticated with a Bearer JWT and require the X-App-Id header. Use the X-Environment header to target the sandbox.

All perk counts

GET /v1/user/perk-counts

Return the user's perk counts across every product type in a single response.

No parameters. Uses the JWT and X-App-Id header.

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

Perk count for a product type

GET /v1/user/perk-counts/{product_type}

Return the user's perk count for a single product type.

curl -X GET 'https://cloud.vanitypass.com/v1/user/perk-counts/{product_type}' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Perk count history

GET /v1/user/perk-counts/{product_type}/history

Return the history of perk-count changes for a product type — how the user's inventory for that product type has moved over time.

curl -X GET 'https://cloud.vanitypass.com/v1/user/perk-counts/{product_type}/history' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \