Skip to content
Apple Wallet

Apple Wallet Pass API

Issue, sign, and update native .pkpass files for iOS and watchOS via REST API. Certificate management, APNs push updates, and device registration handled automatically.

  • Signed .pkpass generation
  • Automatic WWDR cert management
  • APNs lock-screen push updates
  • TypeScript / Node.js SDK
Works on:
 Apple Wallet (.pkpass)Google Wallet (JWT & REST)

Passinstance REST API Explorer

v1.1 Live

Interactive examples for Auth, Template creation, and Pass issuance

POST/api/v1/passes
Issue a personalized Apple Wallet & Google Wallet pass bundle with direct download links.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: pi_live_9f82c4018e6a4b12" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Response Payload
201 Created52ms
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Overview

The Passinstance Apple Wallet API enables developers to generate, sign, and update Apple Wallet passes (.pkpass) without setting up Apple Developer Pass Type IDs, WWDR intermediate certificates, or APNs servers.

Supports all native Apple Wallet pass types: loyalty cards, store cards, coupons, event tickets, boarding passes, and generic passes. Update pass text, colors, barcodes, or expiration dates programmatically via HTTP REST calls.

Capabilities

Everything to run wallet passes in production

Apple Wallet .pkpass signing & delivery

Generate cryptographically signed .pkpass bundles ready for instant addition to iPhone, Apple Watch, and Mac.

APNs push update infrastructure

Trigger native iOS lock-screen push notifications whenever pass data changes in your system.

Wallet pass API

Create, update, and revoke passes programmatically with a REST API and webhooks for install, update, and redemption events.

QR codes and download links

Distribute passes through hosted Add to Wallet pages, QR codes, email, SMS, or POS — customers install in one tap, no app required.

Update notifications

Push live field changes and lock-screen notifications when a balance, status, gate, or offer changes — passes stay current on every device.

Geolocation and relevant locations

Attach relevant locations so a pass surfaces on the lock screen when a customer is near your store, venue, or pickup point.

Dates, expiry, and lifecycle

Set relevant dates and expiration, extend validity on scan, and manage the full pass lifecycle from issue to revoke.

Analytics and tracking

Track installs, removals, scans, and redemptions per pass and cohort, with CSV and API exports for your own reporting.

FAQ

Frequently asked questions

Do I need an Apple Developer Account to use the Apple Wallet API?

No. Passinstance provides pre-configured signing certificates and Pass Type IDs. Alternatively, enterprise customers can upload their own Apple certificates.

What pass types does the Apple Wallet API support?

The API supports coupon, eventTicket, loyalty, storeCard, boardingPass, and generic pass types.

Build on the Apple Wallet API

Get your API key and issue your first signed Apple Wallet pass in minutes.