Skip to content
Help Center Guide · Dashboard OverviewOnboarding Phase 6
3 min readVerified 2026-11-16

Understand Your Workspace

Read Workspace KPIs, Pass Health charts, Active in Wallets vs. Not Installed counts, and tenant workspace isolation.

In This Guide

Interactive UI Walkthroughs

Open in 6-Phase Onboarding Guide

Inspect exact dashboard panels, controls, and zoomed callouts related to this guide.

Zoomed UI focus
Key UI elements

Pass health & Recommended actions (Zoomed)

Track the active vs. uninstalled ratio in Pass health and act on automated recommendations such as following up on passes awaiting wallet installation.

Workspace Health & Live Telemetry

Every Passinstance account operates within a strictly partitioned tenant workspace. All assets created within a workspace — including visual templates, cryptographic signing certificates, custom properties, customer pass records, API secrets, and point-of-sale scan history — are scoped to your workspace ID (customerId) and completely isolated from other organizations.

Pass health summary and action card
Pass health summary and action card

Multi-Tenant Architecture & Workspace Hierarchy

Passinstance implements a two-tier organizational hierarchy separating account billing governance from daily pass management:

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
MULTI-TENANT HIERARCHY
STAGE 01 ORGANIZATION (Account Level)
Platform Resource: Organization
Roles (OrganizationMemberRole): OWNER, ADMIN, MEMBER
Centralized Subscription Plan Quotas & Consolidated Stripe Billing
STAGE 02 1:N Workspaces
PRODUCTION WORKSPACE
Customer Record: cust_prod_901
Kind: production
Production Apple .p12 & Google Auth
Live Customer Wallets & Scanners
Meters Active Wallet Quota
SANDBOX WORKSPACE
Customer Record: cust_sbx_902
Kind: sandbox
Demo Signing & Test Passes
Isolated Testing Environment
Zero Impact on Plan Limits

Managing Sibling Workspaces via Organization API

Teams managing multiple brands, client accounts, or sandbox environments can interact with the Organizations API:

Endpoint PathMethodAuthFunctionality
/api/v1/organizations/currentGETBearerReturns the active organization, member roles, and list of accessible sibling workspaces.
/api/v1/organizations/current/billing-summaryGETBearerRollup of plan limits and cumulative active pass counts across all workspaces.
/api/v1/organizations/current/workspacesPOSTBearerCreates a new sibling workspace (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerSwitches the active tenant context and rotates auth session cookies.

Core Telemetry Metrics Taxonomy

To monitor your pass program accurately, Passinstance distinguishes between server-side record creation and physical wallet installation:

TEXT
Pass Created (POST /api/v1/passes)  ================>  unclaimedPasses (Not Installed)
                                                               |
                                                               | Customer Adds to Wallet
                                                               v
Device Registered (POST /v1/devices/...) ===========>  installedDevices (Installed)
                                                               |
                                                               | Customer Deletes from Wallet
                                                               v
Device Unregisters (DELETE /v1/devices/...) ========>  inactivePasses / inactiveDeviceRegistrations

Definitions from metric-definitions.ts

  • totalPasses (Total Passes Issued): Cumulative count of live pass records generated in your workspace that have not been deleted at snapshot time.
  • activePasses (Active Passes): Live pass instances that currently have at least one reachable device registration (excluding expired and voided passes).
  • installedDevices (Active Device Registrations): Reachable saved pass registrations across Apple APNs and Google Wallet. If one pass is saved on two devices, it counts as two active registrations and meters plan capacity.
  • unclaimedPasses (Unclaimed Passes): Live pass instances issued in Passinstance that have never been saved to a wallet.
  • inactivePasses (Removed Passes): Live pass instances that were previously saved to a wallet, but no longer have any reachable device registrations (including Apple DELETE /v1/devices/... and Google del callbacks to /api/v1/wallet/callback).
  • voidedPasses (Voided Passes) & expiredPasses (Expired Passes): Pass instances revoked server-side or past expirationDate.

Workspace Settings & Regional Configuration

Each workspace is configured independently under Settings -> Workspace (/settings/workspace/*):

  • General & Regional Settings (PUT /api/v1/customer/:customerId/regional-settings): Configures default timezone (resolveCustomerTimeZone), default ISO 4217 currency code, and language locale.
  • Usage Quotas (GET /api/v1/customer/:customerId/usage-summary): Reports real-time total passes, active passes against maxActivePasses, and template counts.
  • Whitelabel Vanity Domains (/api/v1/white-labeling/vanity-urls): Connects custom domains (domain surface type: PASS_DOWNLOAD, PASS_FLOW, BACKEND_UI, etc.) with automated SSL provisioning for all smart links and download pages.

Important: Sandbox workspaces provide an isolated environment to test template revisions, API webhooks, and scanner configurations without consuming active pass capacity from your production plan.

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.