API reference · Passes

Get a pass

GET/v1/passes/{serial}Free

A pass's state: where it's installed, how its latest update was delivered, and its holder and values.

Path

serialstringrequired

The pass's serialNumber.

Answer

200OK

delivery.lastUpdate is how the latest pushed change went: sending, retrying, delivered or failed. template is the template it was made from, while it's still linked.

Errors

Every error has the same shape: see Errors.

Status	Code	When
404	`not_found`	No pass with that serial number in this workspace.

Request

curl "https://api.walletpassapi.com/v1/passes/9f904677-e06d-4b0f-8404-878ff1066f88" \
  -H "Authorization: Bearer $WALLET_API_KEY"

const res = await fetch("https://api.walletpassapi.com/v1/passes/9f904677-e06d-4b0f-8404-878ff1066f88", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.WALLET_API_KEY}`,
  },
});
const data = await res.json();

import os

import requests

res = requests.get(
    "https://api.walletpassapi.com/v1/passes/9f904677-e06d-4b0f-8404-878ff1066f88",
    headers={"Authorization": f"Bearer {os.environ['WALLET_API_KEY']}"},
)
data = res.json()

<?php

$ch = curl_init("https://api.walletpassapi.com/v1/passes/9f904677-e06d-4b0f-8404-878ff1066f88");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("WALLET_API_KEY"),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 OK

{
  "serialNumber": "9f904677-e06d-4b0f-8404-878ff1066f88",
  "status": "active",
  "issuer": "default",
  "externalId": "crm-1042",
  "createdAt": "2026-10-08T19:31:12.000Z",
  "lastUpdated": "2026-10-08T19:31:12.000Z",
  "delivery": {
    "appleDevices": 1,
    "google": "saved",
    "lastUpdate": null
  },
  "data": {},
  "holder": {
    "name": "Priya Shah",
    "email": "priya@example.com"
  },
  "template": null
}