v1.0.0 Specification

Mobile & Integrations REST API

Versioned API endpoints under /api/v1/ for future iOS & Android applications.

Authentication

Protected endpoints require a Sanctum Bearer Token. Include the header in your requests:

Authorization: Bearer <YOUR_TOKEN>

POST /api/v1/register Register new user and get Sanctum token

POST /api/v1/login Authenticate user credentials and receive token

POST /api/v1/logout Revoke current API access token Auth

GET /api/v1/me Get authenticated user information & card status Auth

GET /api/v1/card Retrieve authenticated user's digital business card Auth

POST /api/v1/card Create user's single digital business card (enforces 1 card limit) Auth

PUT /api/v1/card Update existing digital card fields Auth

PUT /api/v1/card/template Switch presentation template without touching card data Auth

GET /api/v1/card/qr-code Retrieve card public QR SVG & direct download URL Auth

GET /api/v1/card/vcard Download RFC 6350 vCard (.vcf) stream Auth

GET /api/v1/card/wallet-pass Download Apple Wallet binary .pkpass package Auth

GET /api/v1/templates List all 8 active presentation templates