API reference · Templates

List templates

GET/v1/templatesFree

This workspace's templates by name, then those your organization shares with it (org:<slug>).

Answer

200OK

passes is how many passes are made from each, and outdated how many of those are on an older version.

Errors

Every error has the same shape: see Errors.

Status	Code	When

Request

curl "https://api.walletpassapi.com/v1/templates" \
  -H "Authorization: Bearer $WALLET_API_KEY"

const res = await fetch("https://api.walletpassapi.com/v1/templates", {
  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/templates",
    headers={"Authorization": f"Bearer {os.environ['WALLET_API_KEY']}"},
)
data = res.json()

<?php

$ch = curl_init("https://api.walletpassapi.com/v1/templates");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("WALLET_API_KEY"),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 OK

{
  "templates": [
    {
      "slug": "gold-member",
      "name": "Gold member",
      "design": {
        "organizationName": "Acme Coffee",
        "logoText": "Acme",
        "style": "loyalty",
        "primaryFields": [
          {
            "key": "points",
            "label": "Points",
            "value": "{{points}}",
            "changeMessage": "You now have %@ points"
          }
        ],
        "secondaryFields": [
          {
            "key": "member",
            "label": "Member",
            "value": "{{holder.name}}"
          }
        ],
        "barcodeValue": "{{member_id}}",
        "barcodeFormat": "QR"
      },
      "placeholders": [
        {
          "key": "points",
          "type": "number",
          "required": true
        },
        {
          "key": "member_id",
          "label": "Member ID",
          "type": "text",
          "required": true
        }
      ],
      "keys": [
        "points",
        "holder.name",
        "member_id"
      ],
      "holderRequired": {
        "name": true,
        "email": false
      },
      "issuer": null,
      "installHeadline": null,
      "version": 1,
      "passes": 1200,
      "outdated": 0,
      "organization": false,
      "createdAt": "2026-10-08T19:31:12.000Z",
      "updatedAt": "2026-10-08T19:31:12.000Z"
    }
  ]
}