---
title: "Update Pass Template"
method: PATCH
path: "/api/v1/pass-templates/{id}"
tags: ["Pass Templates"]
---

# Update Pass Template

`PATCH /api/v1/pass-templates/{id}`

## Path parameters

- `id` string, required

## Request body

- object — Pass Template object
  - `passTemplate` object, required
    - `name` string, required — Name of the pass template, used for display purposes
    - `centralTitle` string, required — Used for Google Wallet Passes, pass Title
    - `notificationHeader` string, required — Header text to be displayed on notifications
    - `description` string, required — Description of the pass template. This text is used as the notification header for Android geofencing alerts.
    - `templateType` 'eventTicket' | 'loyalty' | 'generic' | 'transit', required — Type of pass template, determines the design and functionality of the pass
    - `defaultLanguage` string, required — Language code (ISO 639-1) used as the default language for labels on this template
    - `colors` PassTemplateColors, required
      - `background` string — Background color of the pass template
      - `label` string — Label color of the pass template
      - `text` string — Text color of the pass template
    - `images` PassTemplateImages, required
      - `banner` string — Banner image URL, used unless platform specific images are provided
      - `logo` string — Logo image URL, used unless platform specific images are provided
      - `icon` string — Icon image URL, used unless platform specific images are provided
      - `watermark` ImageWatermark
        - `color` 'light' | 'dark' — Color of the watermark, light or dark
        - `position` 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' — Position of the watermark, top left, top right, bottom left, or bottom right
      - `apple` object
        - `banner` string — Banner image URL, used for Apple Wallet
        - `logo` string — Logo image URL, used for Apple Wallet
        - `icon` string — Icon image URL, used for Apple Wallet
        - `thumbnail` string — Thumbnail image URL, used for Apple Wallet
        - `watermark` ImageWatermark
          - `color` 'light' | 'dark' — Color of the watermark, light or dark
          - `position` 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' — Position of the watermark, top left, top right, bottom left, or bottom right
      - `google` object
        - `banner` string — Banner image URL, used for Google Wallet
        - `logo` string — Logo image URL, used for Google Wallet
        - `wideLogo` string — Wide logo image URL, used for Google Wallet
        - `watermark` ImageWatermark
          - `color` 'light' | 'dark' — Color of the watermark, light or dark
          - `position` 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' — Position of the watermark, top left, top right, bottom left, or bottom right
    - `fields` object, required — Fields for the pass template, for exact positioning of fields please review our design guidelines
      - `header` object
        - `one` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `two` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
      - `central` object — Central field for the pass template. **Note**: Please use both `one` and `two` fields for `transit` type
        - `one` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `two` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
      - `details` object
        - `one` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `two` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `three` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `four` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `five` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `six` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
      - `back` object
        - `one` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `two` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `three` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `four` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `five` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `six` Field — Field object. Set value to null to remove the field.
          - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
          - `label` string — Label of the field. This will be displayed to the user in the pass.
          - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
          - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
    - `appLinking` AppLinking — Used to add a link on your pass to an app or website.
      - `apple` object
        - `appStoreUrl` string[]
      - `google` union — Link to your android App or website
        - object
          - `web` object
            - `url` string — HTTPs URL web link, will open in browser when tapped
          - `displayText` object
            - `text` string — Set custom text to be displayed as link text, default is 'Open Pass'
        - object
          - `app` union
            - object
              - …
            - object
              - …
          - `displayText` object
            - `text` string — Set custom text to be displayed as link text, default is 'Open Pass'
    - `locations` Location[] — Array of locations. Maximum of 10 locations
      - `name` string, required — Name of the location, used for display purposes only
      - `latitude` number, double, required — Latitude of the location
      - `longitude` number, double, required — Longitude of the location
      - `radius` integer — Effective geofence radius of the location in meters. Maximum is 1000 for eventTicket passes, 100 for other pass types. Currently only available on Apple devices, due to Android device restrictions.
      - `message` string — Message to display when user enters geofence. Currently only available on Apple devices, due to Android device restrictions.
    - `beacons` Beacon[] — Array of beacons, currently only available on Apple devices, due to Android device restrictions. Maximum of 10 beacons
      - `name` string, required — Name of the beacon, used for display purposes only
      - `proximityUuid` string, required — Unique identifier of the beacon
      - `major` integer — Major Value, provides additional identification for a beacon
      - `minor` integer — Minor Value, provides additional identification for a beacon
      - `message` string, nullable — Message to display on lock screen when the user is in range of the beacon
    - `nfc` Nfc
      - `enabled` boolean — Whether the pass is NFC enabled.
      - `source` 'extId' | 'custom' | 'uuid' — Source of the NFC message
      - `customValue` string — Custom NFC message, source must be set to custom
    - `barcode` Barcode — Barcode for a pass template
      - `enabled` boolean — If true, barcode will be added to the pass
      - `type` 'qr' | 'code128' | 'aztec' | 'pdf417' — Barcode type
      - `source` 'custom' | 'uuid' | 'extId' — Source of the barcode
      - `value` string — Barcode value. You can leave it blank if the value will be dynamically set in the pass, but you can also provide a default. You can make the value dynamic using the `%{passData.xyz}` syntax (e.g., `Hello, %{passData.extId}`). Currently, only `%{passData.extId}` and `%{passData.uuid}` are supported. If `source` is set to `extId` or `uuid`, the value will be automatically populated and can be left blank.
      - `displayText` boolean — If true, display the barcode value as text on the pass
    - `loyaltyBalance` PassTemplateLoyaltyBalance — Loyalty balance for the pass template.
      - `enabled` boolean — If enabled, pass will have a loyalty balance field that can be updated via the loyalty API.
      - `numberType` 'integer' | 'decimal' — Type of number to be displayed on the pass, number will be converted to this type.
    - `googleNfcEnabled` boolean — For loyalty templates, if true, pass will be enabled for Google Wallet NFC.
    - `transitType` 'airplane' | 'bus' | 'train' | 'ferry' | 'other' — Transit type for the transit pass template
    - `hasDynamicForm` boolean — If true, pass template has a dynamic pass issuance form associated with it.
    - `enhancedEventTicket` object — Configuration for Apple's poster event ticket experience (iOS 18+). Only available on event ticket templates and requires both NFC and pass binding entitlements. When images are provided, passes render as full-bleed poster event tickets on iOS 18+ and fall back to the legacy event ticket layout on older devices. ***Note**: This feature is in **closed beta**. The API structure may change and you may encounter bugs. Please contact PassEntry for access.*
      - `images` object — Images for the poster event ticket experience. Providing artwork enables the poster event ticket layout.
        - `artwork` string, required — Full-bleed background of the poster event ticket on iOS 18+. Required to enable poster event ticket layout. Maximum size: 1074x1344 px. Avoid placing important content near top and bottom edges as they overlap with header and chin regions.
        - `secondaryLogo` string — Displayed in the bottom right of the pass chin. Intended to represent the ticket issuer or platform. Maximum size: 405x36 px.
        - `venueMap` string — Static image of the venue layout, displayed in the event guide. Maximum size: 3072x3072 px. 16:9 to 4:5 aspect ratio recommended.

## Response `200`

Successful

- union
  - SerializedPassTemplate
    - `id` string — Unique identifier for the pass template
    - `type` string
    - `attributes` object
      - `name` string — Name of the pass template, used for display purposes
      - `entityId` integer — ID of the entity this pass template belongs to
      - `templateType` 'generic' | 'loyalty' | 'eventTicket' | 'transit'
      - `transitType` 'airplane' | 'bus' | 'train' | 'ferry' | 'other' — Transit type for the transit pass template
      - `defaultLanguage` string — Language code (ISO 639-1) used as the default language for labels on this template
      - `centralTitle` string — Used for Google Wallet Passes, pass Title
      - `notificationHeader` string — Header text to be displayed on notifications
      - `status` 'draft' | 'published' — Lifecycle status of the pass template.
      - `colors` PassTemplateColors
        - `background` string — Background color of the pass template
        - `label` string — Label color of the pass template
        - `text` string — Text color of the pass template
      - `images` PassTemplateImages
        - `banner` string — Banner image URL, used unless platform specific images are provided
        - `logo` string — Logo image URL, used unless platform specific images are provided
        - `icon` string — Icon image URL, used unless platform specific images are provided
        - `watermark` ImageWatermark
          - `color` 'light' | 'dark' — Color of the watermark, light or dark
          - `position` 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' — Position of the watermark, top left, top right, bottom left, or bottom right
        - `apple` object
          - `banner` string — Banner image URL, used for Apple Wallet
          - `logo` string — Logo image URL, used for Apple Wallet
          - `icon` string — Icon image URL, used for Apple Wallet
          - `thumbnail` string — Thumbnail image URL, used for Apple Wallet
          - `watermark` ImageWatermark
            - `color` 'light' | 'dark' — Color of the watermark, light or dark
            - `position` 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' — Position of the watermark, top left, top right, bottom left, or bottom right
        - `google` object
          - `banner` string — Banner image URL, used for Google Wallet
          - `logo` string — Logo image URL, used for Google Wallet
          - `wideLogo` string — Wide logo image URL, used for Google Wallet
          - `watermark` ImageWatermark
            - `color` 'light' | 'dark' — Color of the watermark, light or dark
            - `position` 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' — Position of the watermark, top left, top right, bottom left, or bottom right
      - `fields` PassTemplateFields — Fields for the pass template, for exact positioning of fields please review our design guidelines
        - `header` HeaderField
          - `one` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `two` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `central` CentralField — Central field for the pass template. **Note**: Please use both `one` and `two` fields for `transit` type
          - `one` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `two` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `details` DetailsField
          - `one` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `two` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `three` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `four` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `five` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `six` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
        - `back` BackField
          - `one` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `two` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `three` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `four` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `five` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
          - `six` Field — Field object. Set value to null to remove the field.
            - `id` string — Field ID, used to to target and identify a specific field. Must be unique within the pass template or pass. Required if field is used.
            - `label` string — Label of the field. This will be displayed to the user in the pass.
            - `defaultValue` string — Default value of the field. This will be displayed to the user in the pass if no value is provided.
            - `localisation` object — Optional. Localised overrides for field labels and values, keyed by BCP-47/ISO language code (e.g., en, fr, is). Omitted entirely if no translations are provided. **This feature is available on request and works only via the Pass Templates API (not dashboard), please contact PassEntry to enable localisation for your organisation.**
      - `appLinking` AppLinking — Used to add a link on your pass to an app or website.
        - `apple` object
          - `appStoreUrl` string[]
        - `google` union — Link to your android App or website
          - object
            - `web` object
              - …
            - `displayText` object
              - …
          - object
            - `app` union
              - …
            - `displayText` object
              - …
      - `locations` SerializedLocation[] — Array of locations. Maximum of 10 locations
        - `name` string — Name of the location, used for display purposes only
        - `latitude` number, double — Latitude of the location
        - `longitude` number, double — Longitude of the location
        - `radius` integer — Effective geofence radius of the location in meters. Maximum is 1000 for eventTicket passes, 100 for other pass types. Currently only available on Apple devices, due to Android device restrictions.
        - `message` string — Message to display when user enters geofence. Currently only available on Apple devices, due to Android device restrictions.
        - `address` string — Geocoded address of the location. Used for display purposes only. This is calculated automatically from the latitude and longitude values
      - `beacons` Beacon[] — Array of beacons, currently only available on Apple devices, due to Android device restrictions. Maximum of 10 beacons
        - `name` string, required — Name of the beacon, used for display purposes only
        - `proximityUuid` string, required — Unique identifier of the beacon
        - `major` integer — Major Value, provides additional identification for a beacon
        - `minor` integer — Minor Value, provides additional identification for a beacon
        - `message` string, nullable — Message to display on lock screen when the user is in range of the beacon
      - `barcode` Barcode — Barcode for a pass template
        - `enabled` boolean — If true, barcode will be added to the pass
        - `type` 'qr' | 'code128' | 'aztec' | 'pdf417' — Barcode type
        - `source` 'custom' | 'uuid' | 'extId' — Source of the barcode
        - `value` string — Barcode value. You can leave it blank if the value will be dynamically set in the pass, but you can also provide a default. You can make the value dynamic using the `%{passData.xyz}` syntax (e.g., `Hello, %{passData.extId}`). Currently, only `%{passData.extId}` and `%{passData.uuid}` are supported. If `source` is set to `extId` or `uuid`, the value will be automatically populated and can be left blank.
        - `displayText` boolean — If true, display the barcode value as text on the pass
      - `loyaltyBalance` PassTemplateLoyaltyBalance — Loyalty balance for the pass template.
        - `enabled` boolean — If enabled, pass will have a loyalty balance field that can be updated via the loyalty API.
        - `numberType` 'integer' | 'decimal' — Type of number to be displayed on the pass, number will be converted to this type.
      - `googleNfcEnabled` boolean — Only included on loyalty templates, if true, pass will be enabled for Google Wallet NFC.
      - `hasDynamicForm` boolean — If true, pass template has a dynamic pass issuance form associated with it.
      - `enhancedEventTicket` object — Poster event ticket configuration. Only present on event ticket templates with enhanced event ticket enabled. ***Note**: This feature is in **closed beta**. The API structure may change and you may encounter bugs. Please contact PassEntry for access.*
        - `images` object — Poster event ticket images.
          - `artwork` string — URL of the artwork image.
          - `secondaryLogo` string — URL of the secondary logo image.
          - `venueMap` string — URL of the venue map image.
  - SerializedProcessingPassTemplate
    - `id` string — Unique identifier for the pass template
    - `type` string
    - `attributes` object
      - `name` string — Name of the pass template, used for display purposes
      - `templateType` 'eventTicket' | 'loyalty' | 'generic' | 'transit' — Type of pass template, determines the design and functionality of the pass
      - `transitType` 'airplane' | 'bus' | 'train' | 'ferry' | 'other' — Transit type for the transit pass template
      - `processingStatus` 'processing' | 'processed' | 'failed' | 'updating' — Processing status of the pass template
      - `status` 'draft' | 'published' — Lifecycle status of the pass template.
    - `meta` object
      - `message` string — Processing status message
      - `links` object
        - `self` string — URL to the pass template. Use this URL to retrieve the pass template once it has been processed.

## Other responses

- `202` — Successful
- `400` — Error: Bad Request
- `401` — Error: Unauthorized
- `404` — Error: Not Found

---

[API](https://skmtc.net/passentry/apis/passentry-api.md) · [All operations](https://skmtc.net/passentry/apis/passentry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/passentry/passentry-api/versions/2c7dc0306b04/schema)
