API reference · Passes

List passes

GET/v1/passesFree

Your workspace's passes, newest first, found by any text in them and filtered by their state.

Query

qstring

Text in the pass (labels, values, names, the barcode), its serial number or external ID, or its holder's name or email. Not case-sensitive.

statusactive · revoked

Only passes in this state.

issuerstring

Only passes signed with this set: its slug, org:<slug> for your organization's, or platform for test passes.

createdFromdate

Made on or after this day (YYYY-MM-DD, UTC).

createdTodate

Made on or before this day.

appleInstalledtrue · false

On at least one Apple device, or on none.

googleSavedtrue · false

Saved to Google Wallet, or not.

templatestring

Made from this template (its slug).

templateOutdatedtrue · false

On an older version of its template, or on the latest.

limit1 to 100

How many to return. Default 50, at most 100.

cursorstring

nextCursor from the page before, for the next page.

page1 to 10,000

A numbered page instead of a cursor: the answer adds total and page. Not with cursor. See Paging.

Answer

200OK

nextCursor is null on the last page. A pass never moves between pages while you page through, even as new ones are made.

Errors

Every error has the same shape: see Errors.

Status	Code	When
400	`validation_error`	A filter isn't valid, or both `page` and `cursor` are sent.
400	`invalid_cursor`	The cursor isn't one this endpoint returned.
422	`unknown_issuer`	No issuer with that slug here.

Request

curl "https://api.walletpassapi.com/v1/passes?q=crm-1042&status=active" \
  -H "Authorization: Bearer $WALLET_API_KEY"

const res = await fetch("https://api.walletpassapi.com/v1/passes?q=crm-1042&status=active", {
  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",
    headers={"Authorization": f"Bearer {os.environ['WALLET_API_KEY']}"},
    params={
        "q": "crm-1042",
        "status": "active",
    },
)
data = res.json()

<?php

$ch = curl_init("https://api.walletpassapi.com/v1/passes?q=crm-1042&status=active");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("WALLET_API_KEY"),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 OK

{
  "passes": [
    {
      "serialNumber": "9f904677-e06d-4b0f-8404-878ff1066f88",
      "status": "active",
      "title": "Acme",
      "organizationName": "Acme Coffee",
      "externalId": "crm-1042",
      "issuer": "default",
      "appleDevices": 1,
      "google": "saved",
      "createdAt": "2026-10-08T19:31:12.000Z",
      "updatedAt": "2026-10-08T19:31:12.000Z"
    }
  ],
  "nextCursor": "MTc5MTQ4NzkzNTgwMy5wYXNz…"
}