Interactive Demo

MintPass Demo

Explore the MintPass entitlement protocol hands-on. Walk through core flows — issuance, lifecycle management, coverage evaluation, and enforcement — using live API calls against the running instance.

Animated Protocol Flow

A live sequence showing the complete MintPass developer experience — container creation, entitlement issuance, execution, idempotency replay, and Guardian enforcement. All requests use real MintPass field names.

mintpass — api protocol flow
Step 1 / 6

Core Flows

Issuance

Issue an Entitlement

Create a new entitlement from a template, set its validity window, and receive a signed entitlement record.

Lifecycle

Manage States

Transition an entitlement through its six-state lifecycle — from draft to active, suspended, or revoked.

Coverage

Evaluate Coverage

Run a read-only coverage computation against an entitlement bundle to determine which events are covered at a point in time.

Enforcement

Apply Overlays

Freeze, suspend, restrict, or place a hold on entitlements via the enforcement overlay layer without mutating the core record.

Authorisation

Approval Gate

Request, approve, or reject an execution via the authorisation decisions layer before committing entitlement consumption.

Settlement

Trace Settlements

Follow an execution receipt through to a settlement record, verifying that ledger events are produced and linked end-to-end.

Example Requests

Request 
# Issue an entitlement from a template
POST /api/commerce/execute
Content-Type: application/json

{
  "template_id": "tpl_annual_coverage_v1",
  "holder_id":   "ent_holder_0001",
  "valid_from":  "2026-01-01T00:00:00Z",
  "valid_until": "2027-01-01T00:00:00Z",
  "metadata": {
    "plan":   "premium",
    "seats":  5
  }
}
# Transition entitlement to active state
POST /api/lifecycle/{entitlement_id}/activate
Content-Type: application/json

{
  "actor_id":  "actor_admin_001",
  "reason":   "Initial activation after issuance",
  "timestamp": "2026-03-21T07:00:00Z"
}
# Evaluate coverage at a point in time
POST /api/coverage/evaluate
Content-Type: application/json

{
  "entitlement_id": "ent_0001",
  "event_type":     "claim.submit",
  "event_date":     "2026-06-15",
  "event_value":    1200.00
}
# Verify an entitlement by holder + type
GET /api/verify?holder_id=ent_holder_0001&event_type=claim.submit

Response:
{
  "verified":    true,
  "entitlement": "ent_0001",
  "state":       "active",
  "coverage":    "in_window",
  "checked_at":  "2026-03-21T07:00:00Z"
}

Live API

Run a read-only request against the running MintPass instance. No credentials required for health and verification endpoints. 


            


            


            

            
Live Demo — Event Entry + Venue Perks


            

                
Verify once at the gate, trust everywhere inside.

                

                    A real event: two entitlements, one dependency. The Event Ticket is ID-checked at the door.
                    The Venue Perk (drink token, merch credit, backstage pass) can only be claimed once entry is confirmed.
                

                

                    
🎟 Event Ticket (A)
Entry to venue · ID-verified at gate · Revoking it locks out everything downstream.

                    
🍺 Venue Perk (B)
Drink token · Merch credit · Backstage pass · Auto-suspended if ticket is revoked.

                

                

                    BLOCKS_ON dependency: identity checked once at entry → everything downstream inherits that verification.
                

            


            


                
                

                    
                    
                    
                    
                    
                    
                    
                    
                


                
                
Ready — click 1. Issue Passes to begin.


                
                

                    
                    

                        No active passes — click 1. Issue Passes to create an Event Ticket and Venue Perk.
                    


                    
                    

                    
                    

                    
                    
                


                
                

                    

                        Event Trace Log
                        0 events
                    

                    

                        
No events yet — issue passes and walk through the scenario.

                    

                


            


            


            
            
Explore Further

            

                
                    Interactive
                    
Swagger UI

                    
Test any endpoint directly in the browser with full request/response inspection.

                
                
                    Reference
                    
API Reference

                    
Complete endpoint catalogue with schemas, response models, and event type definitions.

                
                
                    Dashboard
                    
Verification Dashboard

                    
Visual interface for verifying entitlements and inspecting lifecycle history.

                
                
                    Specification
                    
Protocol Specification

                    
Canonical definitions for every primitive, state, and enforcement layer in the protocol.