Quick links

Quickstart GuideAPI reference 66 endpointsAuthentication GuideScopes & presets 32 scopesToken lifecycle GuideErrors ReferenceToken console Tool
Documentation menu
QuickstartAuthenticationScopes & presetsToken lifecycleErrorsSecurityJWT & other authAPI referenceToken console

Memberships endpoint

Read one membership pass template.

GET /memberships/pass-templates/:templateId requires the explicit memberships:read scope when called with a merchant API token.

GET/memberships/pass-templates/:templateIdTry it

Request

Read one membership pass template. The path is relative to the global /api/v1 prefix.

MethodGET
AuthenticationAPI token or JWT
Required token scopememberships:read
ResourceMemberships

Authorization

Memberships readmemberships:read

Read membership catalog and merchant activity.

Scope is only one layer.Pass detail queries include the authenticated merchant ID to prevent cross-merchant resource access.

Interactive JWT requests bypass API-token scope metadata, but continue through the normal role, merchant, and permission guards. API tokens are denied on routes without an explicit token policy.

Parameters & body

NameLocationRequiredDescription
templateIdPathYesResource identifier supplied in the documented route path.

Query parameters are not specified by API.md. Use the feature service contract for filters, pagination, or export options.

Examples

Replace each :parameter segment and provide a server-side environment variable for the bearer credential.

cURL

cURL
curl -X GET 'https://api.usevouchify.com/api/v1/memberships/pass-templates/:templateId' \
  -H "Authorization: Bearer $VOUCHIFY_TOKEN"

JavaScript

Node.js
const response = await fetch(
  'https://api.usevouchify.com/api/v1/memberships/pass-templates/:templateId',
  {
    method: 'GET',
    headers: {
      Authorization: `Bearer ${process.env.VOUCHIFY_TOKEN}`
    }
  }
);

if (!response.ok) {
  throw new Error(`Vouchify request failed: ${response.status}`);
}

const contentType = response.headers.get('content-type') || '';
const responseBody = await response.text();
const result = responseBody && contentType.includes('application/json')
  ? JSON.parse(responseBody)
  : responseBody || null;

Response contract

API.md states that response bodies are produced by existing feature services; their resource-specific schemas are authoritative. The merchant-token document does not publish a stable success schema or feature-specific error list for this route.

Authentication errors

401 for invalid/inactive credentials; 403 for missing scopes, blocked routes, or inactive merchant state.

Feature errors

Validation, not-found, and conflict errors are owned by the underlying feature service and are not enumerated in API.md.