Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.
Not recommended: prefer the permanent link field, which is returned on every pass response, never expires, and resolves to the applicable wallet action for any wallet type.
Semantic tags for Apple Wallet passes: seating, flight, event and location details that Wallet and Siri use for suggestions. All fields are optional; send the ones that apply to your pass type.
Attribution: whose surface created the pass (origin), how it was created (mechanism) and where the person came from (channel + campaign). Every field is optional; absent fields default to origin MERCHANT, mechanism API, channel inferred, reference = request id.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stell","description":"Guides and API reference for Stell: design, issue and update Apple Wallet and Google Wallet passes for loyalty, memberships, tickets and access.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/stell/C_zhUrQoTUQsZ2Th/logo/light.svg?fit=max\u0026auto=format\u0026n=C_zhUrQoTUQsZ2Th\u0026q=85\u0026s=0331e63db80863763f108a9e957b9b1d","dark":"https://mintcdn.com/stell/C_zhUrQoTUQsZ2Th/logo/dark.svg?fit=max\u0026auto=format\u0026n=C_zhUrQoTUQsZ2Th\u0026q=85\u0026s=887c7ef4687b8beb0bfc6263349c508b"},"favicon":"https://mintcdn.com/stell/k_mnJ8Kr2DM3UI1t/favicon.svg?fit=max\u0026auto=format\u0026n=k_mnJ8Kr2DM3UI1t\u0026q=85\u0026s=c10d1de1b75b3b3a459cd9b2634f566f","api":{"playground":{"display":"simple"},"examples":{"languages":["typescript","bash","python"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://getstell.com/contact?context=docs:navbar","label":"Talk to Stell"},{"href":"mailto:hello@getstell.com","label":"Support"}],"primary":{"type":"button","label":"Open portal","href":"https://platform.getstell.com/portal"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/stell-tech-as","youtube":"https://www.youtube.com/@getstell","github":"https://github.com/Stell-Tech"},"links":[{"items":[{"label":"getstell.com","href":"https://getstell.com"},{"label":"Book a demo","href":"https://getstell.com/contact?context=docs:footer"},{"label":"Partners and integrations","href":"https://getstell.com/partners"},{"label":"Support","href":"mailto:hello@getstell.com"}]}]},"seo":{"metatags":{"canonical":"https://docs.getstell.com","og:site_name":"Stell Docs","twitter:card":"summary_large_image"},"organization":{"id":"https://getstell.com/#organization","name":"Stell","legalName":"Stell Tech AS","url":"https://getstell.com","logo":"https://getstell.com/brand/stell-wordmark-navy.svg","sameAs":["https://www.linkedin.com/company/stell-tech-as/","https://www.youtube.com/@getstell","https://github.com/Stell-Tech"]}},"contextual":{"options":["copy","view","claude","chatgpt","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stell","hasAudioNarration":false,"actualSubdomain":"stell","customDomains":["docs.getstell.com"],"gitSource":{"type":"github","owner":"stell-tech","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea58a7dfbaebaa6b1d3912","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API reference","count":64},{"language":"default","tag":"Merchant portal","count":20},{"language":"default","tag":"Passes","count":15},{"language":"default","tag":"Launch \u0026 grow","count":13},{"language":"default","tag":"Programs","count":8},{"language":"default","tag":"Pass Templates","count":7},{"language":"default","tag":"Engage","count":6},{"language":"default","tag":"Pass templates","count":6},{"language":"default","tag":"Engagement","count":6},{"language":"default","tag":"Integration guide","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".frame{margin-top:1.75rem;margin-bottom:1.75rem}.task-list-item::before{content:none}.task-list-item{position:relative;margin-left:10px}.task-list-item>input[type=\"checkbox\"]{position:absolute;left:-2px;top:7px;margin:0}"}],"page":{"pagePath":"api-reference/passes/create-new-pass","slug":"/api-reference/passes/create-new-pass","pageMetadata":{"title":"Create new pass","description":"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes","href":"/api-reference/passes/create-new-pass","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create new pass","description":"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes","href":"/api-reference/passes/create-new-pass","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Passes"],"summary":"Create new pass","description":"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.","operationId":"createPass","parameters":["e30210eb-0675-495d-bbbe-d57cfbb2d859"],"requestBody":"445f7401-133e-41cb-b5c6-b21c605c81a4","responses":{"201":"ff4b93b1-5062-4d37-b854-94d972fb2811","400":"1d574a6c-516a-4d02-9da3-0ecf8b0c4e6e","401":"d80606e1-6ecc-4399-bec5-0d548e93b7fa","403":"e63db5e0-dde2-4f3f-b069-a80d3533a08e","404":"1fb3819c-a7e2-4315-8262-83a267eeef01","500":"ec0bd932-e23f-4187-9fc1-ecf4bbffb03f"},"security":["dace5fa0-b974-41cd-8325-1b7cdef7e793"],"method":"post","type":"path","servers":["7cb07a26-83f2-4be3-9415-240d75b0dd81"],"path":"/v1/passes","baseUrlOptions":["https://api.platform.getstell.com"],"title":"Create new pass","codeSamples":[],"requestExampleLanguages":["typescript","bash","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.programId":"\u003cstring>","body.templateOverrides.logoText":"\u003cstring>","body.templateOverrides.fieldOverrides.backFields.items.0.value":"\u003cstring>","body.templateOverrides.fieldOverrides.backFields.items.0.key":"\u003cstring>","body.templateOverrides.fieldOverrides.backFields.items.0.label":"\u003cstring>","body.templateOverrides.fieldOverrides.secondaryFields.items.0.value":"\u003cstring>","body.templateOverrides.fieldOverrides.secondaryFields.items.0.key":"\u003cstring>","body.templateOverrides.fieldOverrides.secondaryFields.items.0.label":"\u003cstring>","body.templateOverrides.fieldOverrides.mergeStrategy":"MERGE","body.templateOverrides.fieldOverrides.primaryFields.items.0.value":"\u003cstring>","body.templateOverrides.fieldOverrides.primaryFields.items.0.key":"\u003cstring>","body.templateOverrides.fieldOverrides.primaryFields.items.0.label":"\u003cstring>","body.templateOverrides.fieldOverrides.headerFields.items.0.value":"\u003cstring>","body.templateOverrides.fieldOverrides.headerFields.items.0.key":"\u003cstring>","body.templateOverrides.fieldOverrides.headerFields.items.0.label":"\u003cstring>","body.templateOverrides.fieldOverrides.auxiliaryFields.items.0.value":"\u003cstring>","body.templateOverrides.fieldOverrides.auxiliaryFields.items.0.key":"\u003cstring>","body.templateOverrides.fieldOverrides.auxiliaryFields.items.0.label":"\u003cstring>","body.templateOverrides.images.footerImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.footerImage.uploadId":"\u003cstring>","body.templateOverrides.images.artworkImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.artworkImage.uploadId":"\u003cstring>","body.templateOverrides.images.primaryLogoImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.primaryLogoImage.uploadId":"\u003cstring>","body.templateOverrides.images.venueMapImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.venueMapImage.uploadId":"\u003cstring>","body.templateOverrides.images.logoImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.logoImage.uploadId":"\u003cstring>","body.templateOverrides.images.iconImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.iconImage.uploadId":"\u003cstring>","body.templateOverrides.images.secondaryLogoImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.secondaryLogoImage.uploadId":"\u003cstring>","body.templateOverrides.images.backgroundImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.backgroundImage.uploadId":"\u003cstring>","body.templateOverrides.images.stripImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.stripImage.uploadId":"\u003cstring>","body.templateOverrides.images.thumbnailImage.sourceUrl":"\u003cstring>","body.templateOverrides.images.thumbnailImage.uploadId":"\u003cstring>","body.templateOverrides.overrideMetadata":{},"body.templateOverrides.overrideReason":"\u003cstring>","body.templateOverrides.maxDistance":2,"body.templateOverrides.actions":{},"body.templateOverrides.colors.backgroundColor":"\u003cstring>","body.templateOverrides.colors.foregroundColor":"\u003cstring>","body.templateOverrides.colors.stripColor":"\u003cstring>","body.templateOverrides.colors.labelColor":"\u003cstring>","body.notificationMessage":"\u003cstring>","body.externalId":"\u003cstring>","body.semanticTagOverrides.eventLiveMessage":"\u003cstring>","body.semanticTagOverrides.leagueAbbreviation":"\u003cstring>","body.semanticTagOverrides.venuePhoneNumber":"\u003cstring>","body.semanticTagOverrides.priorityStatus":"\u003cstring>","body.semanticTagOverrides.tailgatingAllowed":true,"body.semanticTagOverrides.seats.items.0.seatIdentifier":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatType":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatDescription":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatSection":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatRow":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatAisle":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatSectionColor":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatNumber":"\u003cstring>","body.semanticTagOverrides.seats.items.0.seatLevel":"\u003cstring>","body.semanticTagOverrides.attendeeName":"\u003cstring>","body.semanticTagOverrides.leagueName":"\u003cstring>","body.semanticTagOverrides.securityScreening":"\u003cstring>","body.semanticTagOverrides.venueEntrance":"\u003cstring>","body.semanticTagOverrides.destinationGate":"\u003cstring>","body.semanticTagOverrides.playlistIDs.items.0":"\u003cstring>","body.semanticTagOverrides.eventName":"\u003cstring>","body.semanticTagOverrides.vehicleNumber":"\u003cstring>","body.semanticTagOverrides.airplay.items.0.airPlayDeviceGroupToken":"\u003cstring>","body.semanticTagOverrides.homeTeamLocation":"\u003cstring>","body.semanticTagOverrides.silenceRequested":true,"body.semanticTagOverrides.awayTeamAbbreviation":"\u003cstring>","body.semanticTagOverrides.departureAirportCode":"\u003cstring>","body.semanticTagOverrides.vehicleType":"\u003cstring>","body.semanticTagOverrides.departurePlatform":"\u003cstring>","body.semanticTagOverrides.awayTeamLocation":"\u003cstring>","body.semanticTagOverrides.destinationLocationDescription":"\u003cstring>","body.semanticTagOverrides.boardingSequenceNumber":"\u003cstring>","body.semanticTagOverrides.venueEntrancePortal":"\u003cstring>","body.semanticTagOverrides.additionalTicketAttributes":"\u003cstring>","body.semanticTagOverrides.destinationAirportName":"\u003cstring>","body.semanticTagOverrides.membershipProgramNumber":"\u003cstring>","body.semanticTagOverrides.venueOpenDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.admissionLevelAbbreviation":"\u003cstring>","body.semanticTagOverrides.currentBoardingDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.flightNumber":123,"body.semanticTagOverrides.artistIDs.items.0":"\u003cstring>","body.semanticTagOverrides.carNumber":"\u003cstring>","body.semanticTagOverrides.venueName":"\u003cstring>","body.semanticTagOverrides.confirmationNumber":"\u003cstring>","body.semanticTagOverrides.venueParkingLotsOpenDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.originalBoardingDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.awayTeamName":"\u003cstring>","body.semanticTagOverrides.albumIDs.items.0":"\u003cstring>","body.semanticTagOverrides.destinationPlatform":"\u003cstring>","body.semanticTagOverrides.homeTeamAbbreviation":"\u003cstring>","body.semanticTagOverrides.sportName":"\u003cstring>","body.semanticTagOverrides.departureAirportName":"\u003cstring>","body.semanticTagOverrides.wifiAccess.items.0.password":"\u003cstring>","body.semanticTagOverrides.wifiAccess.items.0.ssid":"\u003cstring>","body.semanticTagOverrides.eventStartDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.passengerName.namePrefix":"\u003cstring>","body.semanticTagOverrides.passengerName.familyName":"\u003cstring>","body.semanticTagOverrides.passengerName.givenName":"\u003cstring>","body.semanticTagOverrides.passengerName.nickname":"\u003cstring>","body.semanticTagOverrides.passengerName.nameSuffix":"\u003cstring>","body.semanticTagOverrides.passengerName.middleName":"\u003cstring>","body.semanticTagOverrides.passengerName.phoneticRepresentation":"\u003cstring>","body.semanticTagOverrides.destinationAirportCode":"\u003cstring>","body.semanticTagOverrides.vehicleName":"\u003cstring>","body.semanticTagOverrides.entranceDescription":"\u003cstring>","body.semanticTagOverrides.departureGate":"\u003cstring>","body.semanticTagOverrides.venueEntranceGate":"\u003cstring>","body.semanticTagOverrides.venueRoom":"\u003cstring>","body.semanticTagOverrides.venueFanZoneOpenDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.venueBoxOfficeOpenDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.departureLocationDescription":"\u003cstring>","body.semanticTagOverrides.originalDepartureDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.duration":123,"body.semanticTagOverrides.boardingGroup":"\u003cstring>","body.semanticTagOverrides.currentDepartureDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.destinationTerminal":"\u003cstring>","body.semanticTagOverrides.genre":"\u003cstring>","body.semanticTagOverrides.airlineCode":"\u003cstring>","body.semanticTagOverrides.currentArrivalDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.admissionLevel":"\u003cstring>","body.semanticTagOverrides.originalArrivalDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.eventEndDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.departureTerminal":"\u003cstring>","body.semanticTagOverrides.membershipProgramName":"\u003cstring>","body.semanticTagOverrides.transitProvider":"\u003cstring>","body.semanticTagOverrides.flightCode":"\u003cstring>","body.semanticTagOverrides.transitStatusReason":"\u003cstring>","body.semanticTagOverrides.venueGatesOpenDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.venueEntranceDoor":"\u003cstring>","body.semanticTagOverrides.performerNames.items.0":"\u003cstring>","body.semanticTagOverrides.venueDoorsOpenDate":"2023-11-07T05:31:56Z","body.semanticTagOverrides.transitStatus":"\u003cstring>","body.semanticTagOverrides.venueRegionName":"\u003cstring>","body.semanticTagOverrides.departureStationName":"\u003cstring>","body.semanticTagOverrides.homeTeamName":"\u003cstring>","body.semanticTagOverrides.destinationStationName":"\u003cstring>","body.semanticTagOverrides.venueCloseDate":"2023-11-07T05:31:56Z","body.membershipStatus":"\u003cstring>","body.externalReference":"\u003cstring>","body.payload":"\u003cstring>","body.loyaltyState.memberSince":"2023-11-07T05:31:56Z","body.loyaltyState.stampsCollected":123,"body.loyaltyState.terms":"\u003cstring>","body.loyaltyState.pointsBalance":123,"body.loyaltyState.voucherBalance":123,"body.loyaltyState.description":"\u003cstring>","body.loyaltyState.voucherCurrency":"\u003cstring>","body.loyaltyState.currentTierId":"\u003cstring>","body.loyaltyState.pendingPoints":123,"body.loyaltyState.voucherCount":123,"body.loyaltyState.expirationDate":"2023-11-07T05:31:56Z","body.attribution.referrerHost":"\u003cstring>","body.attribution.reference":"\u003cstring>","body.attribution.campaign.campaign":"\u003cstring>","body.attribution.campaign.term":"\u003cstring>","body.attribution.campaign.source":"\u003cstring>","body.attribution.campaign.medium":"\u003cstring>","body.attribution.campaign.content":"\u003cstring>","body.attribution.landingPath":"\u003cstring>","body.attribution.identityProvider":"\u003cstring>","body.activationDate":"2023-11-07T05:31:56Z","body.customer.firstName":"\u003cstring>","body.customer.lastName":"\u003cstring>","body.customer.emailAddress":"jsmith@example.com","body.customer.personalId":"\u003cstring>","body.customer.lookupSource":"\u003cstring>","body.customer.phone":"\u003cstring>","body.customer.mobileNumber":"\u003cstring>","body.customer.isNew":true,"body.customer.email":"jsmith@example.com","body.expirationDate":"2023-11-07T05:31:56Z"}],"urlDisplay":"full"},"dependencies":{"parameters":{"e30210eb-0675-495d-bbbe-d57cfbb2d859":{"name":"includeWalletLink","in":"query","schema":{"type":"string","description":"Not recommended: prefer the permanent link field, which is returned on every pass response, never expires, and resolves to the applicable wallet action for any wallet type.","uniqueKey":"","typeLabel":"string"},"description":"Not recommended: prefer the permanent link field, which is returned on every pass response, never expires, and resolves to the applicable wallet action for any wallet type."}},"requestBody":{"content":{"application/json":{"schema":{"title":"CreatePassModel","required":["programId","walletType"],"type":"object","properties":{"walletType":{"type":"string","description":"Target wallet platform for the pass","enum":["APPLE_WALLET","GOOGLE_WALLET","SAMSUNG_WALLET"],"isRequired":true,"uniqueKey":"walletType","typeLabel":"enum\u003cstring>"},"programId":{"minLength":1,"type":"string","description":"ID of the program to create a pass for","isRequired":true,"uniqueKey":"programId","typeLabel":"string"},"templateOverrides":{"type":"object","properties":{"logoText":{"maxLength":50,"type":"string","description":"Override logo text (max 50 characters)","uniqueKey":"templateOverrides.logoText","typeLabel":"string"},"fieldOverrides":{"type":"object","properties":{"backFields":{"type":"array","description":"Override back fields","items":{"required":["key","value"],"type":"object","properties":{"value":{"type":"string","description":"Value shown on the pass","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.backFields.items.[INDEX].value","typeLabel":"string"},"key":{"type":"string","description":"Key of the template field to override. Unknown keys add a new field.","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.backFields.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Label shown above the value. Omit to keep the template label.","uniqueKey":"templateOverrides.fieldOverrides.backFields.items.[INDEX].label","typeLabel":"string"}},"description":"One field override","uniqueKey":"templateOverrides.fieldOverrides.backFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"templateOverrides.fieldOverrides.backFields","typeLabel":"object[]"},"secondaryFields":{"type":"array","description":"Override secondary fields","items":{"required":["key","value"],"type":"object","properties":{"value":{"type":"string","description":"Value shown on the pass","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.secondaryFields.items.[INDEX].value","typeLabel":"string"},"key":{"type":"string","description":"Key of the template field to override. Unknown keys add a new field.","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.secondaryFields.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Label shown above the value. Omit to keep the template label.","uniqueKey":"templateOverrides.fieldOverrides.secondaryFields.items.[INDEX].label","typeLabel":"string"}},"description":"One field override","uniqueKey":"templateOverrides.fieldOverrides.secondaryFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"templateOverrides.fieldOverrides.secondaryFields","typeLabel":"object[]"},"mergeStrategy":{"type":"string","description":"Strategy for merging field overrides","enum":["REPLACE","MERGE","APPEND"],"default":"MERGE","uniqueKey":"templateOverrides.fieldOverrides.mergeStrategy","typeLabel":"enum\u003cstring>"},"primaryFields":{"type":"array","description":"Override primary fields","items":{"required":["key","value"],"type":"object","properties":{"value":{"type":"string","description":"Value shown on the pass","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.primaryFields.items.[INDEX].value","typeLabel":"string"},"key":{"type":"string","description":"Key of the template field to override. Unknown keys add a new field.","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.primaryFields.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Label shown above the value. Omit to keep the template label.","uniqueKey":"templateOverrides.fieldOverrides.primaryFields.items.[INDEX].label","typeLabel":"string"}},"description":"One field override","uniqueKey":"templateOverrides.fieldOverrides.primaryFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"templateOverrides.fieldOverrides.primaryFields","typeLabel":"object[]"},"headerFields":{"type":"array","description":"Override header fields","items":{"required":["key","value"],"type":"object","properties":{"value":{"type":"string","description":"Value shown on the pass","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.headerFields.items.[INDEX].value","typeLabel":"string"},"key":{"type":"string","description":"Key of the template field to override. Unknown keys add a new field.","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.headerFields.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Label shown above the value. Omit to keep the template label.","uniqueKey":"templateOverrides.fieldOverrides.headerFields.items.[INDEX].label","typeLabel":"string"}},"description":"One field override","uniqueKey":"templateOverrides.fieldOverrides.headerFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"templateOverrides.fieldOverrides.headerFields","typeLabel":"object[]"},"auxiliaryFields":{"type":"array","description":"Override auxiliary fields","items":{"required":["key","value"],"type":"object","properties":{"value":{"type":"string","description":"Value shown on the pass","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.auxiliaryFields.items.[INDEX].value","typeLabel":"string"},"key":{"type":"string","description":"Key of the template field to override. Unknown keys add a new field.","isRequired":true,"uniqueKey":"templateOverrides.fieldOverrides.auxiliaryFields.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Label shown above the value. Omit to keep the template label.","uniqueKey":"templateOverrides.fieldOverrides.auxiliaryFields.items.[INDEX].label","typeLabel":"string"}},"description":"One field override","uniqueKey":"templateOverrides.fieldOverrides.auxiliaryFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"templateOverrides.fieldOverrides.auxiliaryFields","typeLabel":"object[]"}},"description":"Override pass fields with custom values","uniqueKey":"templateOverrides.fieldOverrides","typeLabel":"object"},"images":{"type":"object","properties":{"footerImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.footerImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.footerImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Footer image above the barcode (boarding passes).","uniqueKey":"templateOverrides.images.footerImage","typeLabel":"object"},"artworkImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.artworkImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.artworkImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Poster artwork (poster event tickets). Apple Wallet only; there is no Google Wallet equivalent.","uniqueKey":"templateOverrides.images.artworkImage","typeLabel":"object"},"primaryLogoImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.primaryLogoImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.primaryLogoImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Poster header logo (poster event tickets and poster-capable generic passes). Apple Wallet only.","uniqueKey":"templateOverrides.images.primaryLogoImage","typeLabel":"object"},"venueMapImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.venueMapImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.venueMapImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Venue map (poster event tickets). Stored at original dimensions. Apple Wallet only.","uniqueKey":"templateOverrides.images.venueMapImage","typeLabel":"object"},"logoImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.logoImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.logoImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Logo shown in the pass header.","uniqueKey":"templateOverrides.images.logoImage","typeLabel":"object"},"iconImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.iconImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.iconImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Icon used in notifications and on the lock screen.","uniqueKey":"templateOverrides.images.iconImage","typeLabel":"object"},"secondaryLogoImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.secondaryLogoImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.secondaryLogoImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Secondary logo (poster event tickets). Apple Wallet only.","uniqueKey":"templateOverrides.images.secondaryLogoImage","typeLabel":"object"},"backgroundImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.backgroundImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.backgroundImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Background image (event tickets and generic passes).","uniqueKey":"templateOverrides.images.backgroundImage","typeLabel":"object"},"stripImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.stripImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.stripImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Strip image below the header. Also becomes the Google Wallet hero image.","uniqueKey":"templateOverrides.images.stripImage","typeLabel":"object"},"thumbnailImage":{"type":"object","properties":{"sourceUrl":{"maxLength":2048,"type":"string","description":"Public HTTPS URL that Stell fetches, validates, resizes and stores. Provide exactly one of sourceUrl or uploadId.","format":"uri","uniqueKey":"templateOverrides.images.thumbnailImage.sourceUrl","typeLabel":"string\u003curi>"},"uploadId":{"maxLength":512,"type":"string","description":"Opaque upload identifier returned by POST /v1/passes/image-uploads. Provide exactly one of sourceUrl or uploadId.","uniqueKey":"templateOverrides.images.thumbnailImage.uploadId","typeLabel":"string"}},"additionalProperties":false,"description":"Thumbnail image (generic passes and event tickets).","uniqueKey":"templateOverrides.images.thumbnailImage","typeLabel":"object"}},"additionalProperties":false,"description":"Per-pass image overrides. Each slot accepts { \"sourceUrl\": \"https://...\" } or { \"uploadId\": \"...\" }. Set a slot to null to clear the override and fall back to the template image; omit a slot to keep its current value. On Google Wallet, stripImage becomes the hero image, and artworkImage is Apple Wallet only.","uniqueKey":"templateOverrides.images","typeLabel":"object"},"overrideMetadata":{"type":"object","additionalProperties":true,"description":"Additional metadata for override context","uniqueKey":"templateOverrides.overrideMetadata","typeLabel":"object"},"overrideReason":{"maxLength":100,"type":"string","description":"Reason for applying overrides (e.g., \"Gold member\", \"VIP status\")","uniqueKey":"templateOverrides.overrideReason","typeLabel":"string"},"maxDistance":{"minimum":1,"type":"integer","description":"Maximum distance (meters) for Apple Wallet location notifications. Overrides template/program defaults. Send null to clear and revert to template/program defaults.","uniqueKey":"templateOverrides.maxDistance","typeLabel":"integer"},"actions":{"type":"object","description":"Pass-level featured actions. When non-empty, fully replaces the template actions array. Send null or an empty array to revert to the template actions.","uniqueKey":"templateOverrides.actions","typeLabel":"object"},"colors":{"type":"object","properties":{"backgroundColor":{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string","description":"Background color in hex format (e.g., \"#FF0000\")","uniqueKey":"templateOverrides.colors.backgroundColor","typeLabel":"string"},"foregroundColor":{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string","description":"Foreground/text color in hex format","uniqueKey":"templateOverrides.colors.foregroundColor","typeLabel":"string"},"stripColor":{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string","description":"Strip color in hex format","uniqueKey":"templateOverrides.colors.stripColor","typeLabel":"string"},"labelColor":{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string","description":"Label color in hex format","uniqueKey":"templateOverrides.colors.labelColor","typeLabel":"string"}},"description":"Override pass colors","uniqueKey":"templateOverrides.colors","typeLabel":"object"}},"additionalProperties":false,"description":"Template overrides for dynamic pass customization based on business logic (e.g., member tiers, promotions). All fields are optional.","uniqueKey":"templateOverrides","typeLabel":"object"},"notificationMessage":{"type":"string","description":"Message shown when the pass is updated (wallet push / pass refresh)","uniqueKey":"notificationMessage","typeLabel":"string"},"externalId":{"type":"string","description":"External reference ID from CRM or other systems","uniqueKey":"externalId","typeLabel":"string"},"semanticTagOverrides":{"type":"object","properties":{"eventLiveMessage":{"maxLength":500,"type":"string","description":"Real-time event status updates (iOS 18+)","uniqueKey":"semanticTagOverrides.eventLiveMessage","typeLabel":"string"},"leagueAbbreviation":{"type":"string","description":"Sports league abbreviation (e.g., NFL, MLB)","uniqueKey":"semanticTagOverrides.leagueAbbreviation","typeLabel":"string"},"venuePhoneNumber":{"type":"string","description":"Venue contact phone number","uniqueKey":"semanticTagOverrides.venuePhoneNumber","typeLabel":"string"},"priorityStatus":{"type":"string","description":"Priority boarding or check-in status","uniqueKey":"semanticTagOverrides.priorityStatus","typeLabel":"string"},"tailgatingAllowed":{"type":"boolean","description":"","uniqueKey":"semanticTagOverrides.tailgatingAllowed","typeLabel":"boolean"},"seats":{"maxItems":10,"type":"array","description":"Seat assignments for events, flights, or venues","items":{"type":"object","properties":{"seatIdentifier":{"maxLength":50,"type":"string","description":"Unique seat identifier combining all components","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatIdentifier","typeLabel":"string"},"seatType":{"maxLength":30,"type":"string","description":"Type or category of seat","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatType","typeLabel":"string"},"seatDescription":{"maxLength":100,"type":"string","description":"Additional seat information","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatDescription","typeLabel":"string"},"seatSection":{"maxLength":20,"type":"string","description":"Section identifier (e.g., Orchestra, Balcony, A)","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatSection","typeLabel":"string"},"seatRow":{"maxLength":10,"type":"string","description":"Row identifier (e.g., 12, A, Front)","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatRow","typeLabel":"string"},"seatAisle":{"maxLength":10,"type":"string","description":"Aisle identifier","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatAisle","typeLabel":"string"},"seatSectionColor":{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string","description":"Color code for section visualization","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatSectionColor","typeLabel":"string"},"seatNumber":{"maxLength":10,"type":"string","description":"Seat number or identifier","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatNumber","typeLabel":"string"},"seatLevel":{"maxLength":10,"type":"string","description":"Level or floor identifier","uniqueKey":"semanticTagOverrides.seats.items.[INDEX].seatLevel","typeLabel":"string"}},"additionalProperties":false,"description":"One seat assignment","uniqueKey":"semanticTagOverrides.seats.items.[INDEX]","typeLabel":"object"},"uniqueKey":"semanticTagOverrides.seats","typeLabel":"object[]"},"attendeeName":{"maxLength":100,"type":"string","description":"Full name of the attendee","uniqueKey":"semanticTagOverrides.attendeeName","typeLabel":"string"},"leagueName":{"type":"string","description":"Sports league full name","uniqueKey":"semanticTagOverrides.leagueName","typeLabel":"string"},"securityScreening":{"type":"string","description":"Security screening type (e.g., TSA PreCheck)","uniqueKey":"semanticTagOverrides.securityScreening","typeLabel":"string"},"venueEntrance":{"type":"string","description":"Venue entrance name or identifier","uniqueKey":"semanticTagOverrides.venueEntrance","typeLabel":"string"},"destinationGate":{"maxLength":10,"type":"string","description":"Arrival gate identifier","uniqueKey":"semanticTagOverrides.destinationGate","typeLabel":"string"},"balance":{"required":["amount","currencyCode"],"type":"object","properties":{"amount":{"pattern":"^\\d+(\\.\\d{1,2})?$","type":"string","description":"Amount as string for precision (e.g., \"150.75\")","isRequired":true,"uniqueKey":"semanticTagOverrides.balance.amount","typeLabel":"string"},"currencyCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","isRequired":true,"uniqueKey":"semanticTagOverrides.balance.currencyCode","typeLabel":"string"}},"additionalProperties":false,"description":"Account balance for loyalty programs or stored value cards","uniqueKey":"semanticTagOverrides.balance","typeLabel":"object"},"playlistIDs":{"type":"array","description":"List of playlist identifiers","items":{"type":"string","description":"Playlist identifier","uniqueKey":"semanticTagOverrides.playlistIDs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"semanticTagOverrides.playlistIDs","typeLabel":"string[]"},"eventName":{"maxLength":200,"type":"string","description":"Name of the event","uniqueKey":"semanticTagOverrides.eventName","typeLabel":"string"},"vehicleNumber":{"type":"string","description":"Vehicle or route number","uniqueKey":"semanticTagOverrides.vehicleNumber","typeLabel":"string"},"airplay":{"type":"array","description":"AirPlay device configuration","items":{"required":["airPlayDeviceGroupToken"],"type":"object","properties":{"airPlayDeviceGroupToken":{"type":"string","description":"Token for AirPlay device group identification","isRequired":true,"uniqueKey":"semanticTagOverrides.airplay.items.[INDEX].airPlayDeviceGroupToken","typeLabel":"string"}},"description":"One AirPlay device","uniqueKey":"semanticTagOverrides.airplay.items.[INDEX]","typeLabel":"object"},"uniqueKey":"semanticTagOverrides.airplay","typeLabel":"object[]"},"homeTeamLocation":{"type":"string","description":"Home team city or location","uniqueKey":"semanticTagOverrides.homeTeamLocation","typeLabel":"string"},"silenceRequested":{"type":"boolean","description":"Whether silent mode is requested for notifications","uniqueKey":"semanticTagOverrides.silenceRequested","typeLabel":"boolean"},"awayTeamAbbreviation":{"maxLength":10,"type":"string","description":"Away team abbreviation for sports events","uniqueKey":"semanticTagOverrides.awayTeamAbbreviation","typeLabel":"string"},"departureAirportCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"IATA departure airport code","uniqueKey":"semanticTagOverrides.departureAirportCode","typeLabel":"string"},"vehicleType":{"type":"string","description":"Type of vehicle (e.g., Bus, Train, Ferry)","uniqueKey":"semanticTagOverrides.vehicleType","typeLabel":"string"},"departurePlatform":{"maxLength":20,"type":"string","description":"Train departure platform","uniqueKey":"semanticTagOverrides.departurePlatform","typeLabel":"string"},"awayTeamLocation":{"maxLength":50,"type":"string","description":"Away team city or location","uniqueKey":"semanticTagOverrides.awayTeamLocation","typeLabel":"string"},"destinationLocationDescription":{"maxLength":100,"type":"string","description":"Descriptive destination location","uniqueKey":"semanticTagOverrides.destinationLocationDescription","typeLabel":"string"},"boardingSequenceNumber":{"maxLength":10,"type":"string","description":"Boarding sequence or position number","uniqueKey":"semanticTagOverrides.boardingSequenceNumber","typeLabel":"string"},"venueEntrancePortal":{"type":"string","description":"","uniqueKey":"semanticTagOverrides.venueEntrancePortal","typeLabel":"string"},"additionalTicketAttributes":{"maxLength":200,"type":"string","description":"Additional ticket features and benefits","uniqueKey":"semanticTagOverrides.additionalTicketAttributes","typeLabel":"string"},"destinationAirportName":{"maxLength":100,"type":"string","description":"Full destination airport name","uniqueKey":"semanticTagOverrides.destinationAirportName","typeLabel":"string"},"membershipProgramNumber":{"type":"string","description":"Member identification number","uniqueKey":"semanticTagOverrides.membershipProgramNumber","typeLabel":"string"},"venueOpenDate":{"type":"string","description":"When the venue opens","format":"date-time","uniqueKey":"semanticTagOverrides.venueOpenDate","typeLabel":"string\u003cdate-time>"},"eventType":{"type":"string","description":"Category of event this pass is for","enum":["PKEventTypeGeneric","PKEventTypeMovie","PKEventTypeConference","PKEventTypeConvention","PKEventTypeWorkshop","PKEventTypeSocialGathering","PKEventTypeSports","PKEventTypeLivePerformance"],"uniqueKey":"semanticTagOverrides.eventType","typeLabel":"enum\u003cstring>"},"admissionLevelAbbreviation":{"maxLength":10,"type":"string","description":"Short form of admission level","uniqueKey":"semanticTagOverrides.admissionLevelAbbreviation","typeLabel":"string"},"currentBoardingDate":{"type":"string","description":"Updated boarding date and time","format":"date-time","uniqueKey":"semanticTagOverrides.currentBoardingDate","typeLabel":"string\u003cdate-time>"},"flightNumber":{"type":"number","description":"Flight number without airline code","uniqueKey":"semanticTagOverrides.flightNumber","typeLabel":"number"},"artistIDs":{"type":"array","description":"List of artist identifiers","items":{"type":"string","description":"Artist identifier","uniqueKey":"semanticTagOverrides.artistIDs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"semanticTagOverrides.artistIDs","typeLabel":"string[]"},"carNumber":{"maxLength":20,"type":"string","description":"Train car or vehicle number","uniqueKey":"semanticTagOverrides.carNumber","typeLabel":"string"},"venueName":{"type":"string","description":"Name of the venue or location","uniqueKey":"semanticTagOverrides.venueName","typeLabel":"string"},"eventStartDateInfo":{"required":["date"],"type":"object","properties":{"date":{"type":"string","description":"Event start date in ISO 8601 format","isRequired":true,"uniqueKey":"semanticTagOverrides.eventStartDateInfo.date","typeLabel":"string"},"ignoreTimeComponents":{"type":"boolean","description":"Whether to ignore time components and use date only","uniqueKey":"semanticTagOverrides.eventStartDateInfo.ignoreTimeComponents","typeLabel":"boolean"},"timeZone":{"type":"string","description":"Time zone identifier (e.g., America/New_York)","uniqueKey":"semanticTagOverrides.eventStartDateInfo.timeZone","typeLabel":"string"}},"description":"Event start date with timezone control","uniqueKey":"semanticTagOverrides.eventStartDateInfo","typeLabel":"object"},"confirmationNumber":{"maxLength":50,"type":"string","description":"Booking or reservation confirmation number","uniqueKey":"semanticTagOverrides.confirmationNumber","typeLabel":"string"},"venueParkingLotsOpenDate":{"type":"string","description":"When the venue parking lots open","format":"date-time","uniqueKey":"semanticTagOverrides.venueParkingLotsOpenDate","typeLabel":"string\u003cdate-time>"},"originalBoardingDate":{"type":"string","description":"Originally scheduled boarding date and time","format":"date-time","uniqueKey":"semanticTagOverrides.originalBoardingDate","typeLabel":"string\u003cdate-time>"},"awayTeamName":{"maxLength":50,"type":"string","description":"Full away team name","uniqueKey":"semanticTagOverrides.awayTeamName","typeLabel":"string"},"albumIDs":{"type":"array","description":"List of album identifiers","items":{"type":"string","description":"Album identifier","uniqueKey":"semanticTagOverrides.albumIDs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"semanticTagOverrides.albumIDs","typeLabel":"string[]"},"destinationPlatform":{"maxLength":20,"type":"string","description":"Train arrival platform","uniqueKey":"semanticTagOverrides.destinationPlatform","typeLabel":"string"},"homeTeamAbbreviation":{"type":"string","description":"Home team abbreviation (e.g., NYY)","uniqueKey":"semanticTagOverrides.homeTeamAbbreviation","typeLabel":"string"},"sportName":{"type":"string","description":"Name of the sport","uniqueKey":"semanticTagOverrides.sportName","typeLabel":"string"},"departureAirportName":{"maxLength":100,"type":"string","description":"Full departure airport name","uniqueKey":"semanticTagOverrides.departureAirportName","typeLabel":"string"},"venueLocation":{"required":["latitude","longitude"],"type":"object","properties":{"latitude":{"maximum":90,"minimum":-90,"type":"number","description":"Latitude in decimal degrees","isRequired":true,"uniqueKey":"semanticTagOverrides.venueLocation.latitude","typeLabel":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number","description":"Longitude in decimal degrees","isRequired":true,"uniqueKey":"semanticTagOverrides.venueLocation.longitude","typeLabel":"number"}},"additionalProperties":false,"description":"Venue location coordinates for events and venues","uniqueKey":"semanticTagOverrides.venueLocation","typeLabel":"object"},"wifiAccess":{"type":"array","description":"WiFi network information","items":{"required":["password","ssid"],"type":"object","properties":{"password":{"type":"string","description":"WiFi network password","isRequired":true,"uniqueKey":"semanticTagOverrides.wifiAccess.items.[INDEX].password","typeLabel":"string"},"ssid":{"type":"string","description":"WiFi network name (SSID)","isRequired":true,"uniqueKey":"semanticTagOverrides.wifiAccess.items.[INDEX].ssid","typeLabel":"string"}},"description":"One WiFi network","uniqueKey":"semanticTagOverrides.wifiAccess.items.[INDEX]","typeLabel":"object"},"uniqueKey":"semanticTagOverrides.wifiAccess","typeLabel":"object[]"},"eventStartDate":{"type":"string","description":"When the event starts","format":"date-time","uniqueKey":"semanticTagOverrides.eventStartDate","typeLabel":"string\u003cdate-time>"},"passengerName":{"type":"object","properties":{"namePrefix":{"maxLength":10,"type":"string","description":"Name prefix (Mr., Ms., Dr., etc.)","uniqueKey":"semanticTagOverrides.passengerName.namePrefix","typeLabel":"string"},"familyName":{"maxLength":50,"type":"string","description":"Last name/surname","uniqueKey":"semanticTagOverrides.passengerName.familyName","typeLabel":"string"},"givenName":{"maxLength":50,"type":"string","description":"First name","uniqueKey":"semanticTagOverrides.passengerName.givenName","typeLabel":"string"},"nickname":{"maxLength":30,"type":"string","description":"Preferred name or nickname","uniqueKey":"semanticTagOverrides.passengerName.nickname","typeLabel":"string"},"nameSuffix":{"maxLength":10,"type":"string","description":"Name suffix (Jr., Sr., III, etc.)","uniqueKey":"semanticTagOverrides.passengerName.nameSuffix","typeLabel":"string"},"middleName":{"maxLength":30,"type":"string","description":"Middle name or initial","uniqueKey":"semanticTagOverrides.passengerName.middleName","typeLabel":"string"},"phoneticRepresentation":{"maxLength":100,"type":"string","description":"Phonetic spelling for pronunciation","uniqueKey":"semanticTagOverrides.passengerName.phoneticRepresentation","typeLabel":"string"}},"additionalProperties":false,"description":"Passenger name components for boarding passes","uniqueKey":"semanticTagOverrides.passengerName","typeLabel":"object"},"destinationAirportCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"IATA destination airport code","uniqueKey":"semanticTagOverrides.destinationAirportCode","typeLabel":"string"},"vehicleName":{"type":"string","description":"Name of the vehicle or service","uniqueKey":"semanticTagOverrides.vehicleName","typeLabel":"string"},"entranceDescription":{"maxLength":200,"type":"string","description":"Description of the entrance location (iOS 18+)","uniqueKey":"semanticTagOverrides.entranceDescription","typeLabel":"string"},"departureGate":{"maxLength":10,"type":"string","description":"Departure gate identifier","uniqueKey":"semanticTagOverrides.departureGate","typeLabel":"string"},"totalPrice":{"required":["amount","currencyCode"],"type":"object","properties":{"amount":{"pattern":"^\\d+(\\.\\d{1,2})?$","type":"string","description":"Amount as string for precision (e.g., \"29.99\")","isRequired":true,"uniqueKey":"semanticTagOverrides.totalPrice.amount","typeLabel":"string"},"currencyCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","isRequired":true,"uniqueKey":"semanticTagOverrides.totalPrice.currencyCode","typeLabel":"string"}},"additionalProperties":false,"description":"Total price for transactions or purchases","uniqueKey":"semanticTagOverrides.totalPrice","typeLabel":"object"},"venueEntranceGate":{"type":"string","description":"","uniqueKey":"semanticTagOverrides.venueEntranceGate","typeLabel":"string"},"venueRoom":{"type":"string","description":"Room or hall within the venue","uniqueKey":"semanticTagOverrides.venueRoom","typeLabel":"string"},"venueFanZoneOpenDate":{"type":"string","description":"When the venue fan zone opens","format":"date-time","uniqueKey":"semanticTagOverrides.venueFanZoneOpenDate","typeLabel":"string\u003cdate-time>"},"venueBoxOfficeOpenDate":{"type":"string","description":"","format":"date-time","uniqueKey":"semanticTagOverrides.venueBoxOfficeOpenDate","typeLabel":"string\u003cdate-time>"},"destinationLocation":{"required":["latitude","longitude"],"type":"object","properties":{"latitude":{"maximum":90,"minimum":-90,"type":"number","description":"Latitude in decimal degrees","isRequired":true,"uniqueKey":"semanticTagOverrides.destinationLocation.latitude","typeLabel":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number","description":"Longitude in decimal degrees","isRequired":true,"uniqueKey":"semanticTagOverrides.destinationLocation.longitude","typeLabel":"number"}},"additionalProperties":false,"description":"Destination location coordinates for transit passes","uniqueKey":"semanticTagOverrides.destinationLocation","typeLabel":"object"},"departureLocationDescription":{"maxLength":100,"type":"string","description":"Descriptive departure location","uniqueKey":"semanticTagOverrides.departureLocationDescription","typeLabel":"string"},"originalDepartureDate":{"type":"string","description":"Originally scheduled departure date and time","format":"date-time","uniqueKey":"semanticTagOverrides.originalDepartureDate","typeLabel":"string\u003cdate-time>"},"duration":{"type":"number","description":"Duration in seconds","uniqueKey":"semanticTagOverrides.duration","typeLabel":"number"},"boardingGroup":{"maxLength":20,"type":"string","description":"Flight boarding group identifier","uniqueKey":"semanticTagOverrides.boardingGroup","typeLabel":"string"},"currentDepartureDate":{"type":"string","description":"Updated departure date and time","format":"date-time","uniqueKey":"semanticTagOverrides.currentDepartureDate","typeLabel":"string\u003cdate-time>"},"destinationTerminal":{"maxLength":20,"type":"string","description":"Airport arrival terminal","uniqueKey":"semanticTagOverrides.destinationTerminal","typeLabel":"string"},"genre":{"type":"string","description":"Event genre or category","uniqueKey":"semanticTagOverrides.genre","typeLabel":"string"},"airlineCode":{"pattern":"^[A-Z0-9]{2,3}$","type":"string","description":"IATA airline code (2-3 characters)","uniqueKey":"semanticTagOverrides.airlineCode","typeLabel":"string"},"currentArrivalDate":{"type":"string","description":"Updated arrival date and time","format":"date-time","uniqueKey":"semanticTagOverrides.currentArrivalDate","typeLabel":"string\u003cdate-time>"},"admissionLevel":{"maxLength":50,"type":"string","description":"Access level or tier","uniqueKey":"semanticTagOverrides.admissionLevel","typeLabel":"string"},"originalArrivalDate":{"type":"string","description":"Originally scheduled arrival date and time","format":"date-time","uniqueKey":"semanticTagOverrides.originalArrivalDate","typeLabel":"string\u003cdate-time>"},"eventEndDate":{"type":"string","description":"When the event ends","format":"date-time","uniqueKey":"semanticTagOverrides.eventEndDate","typeLabel":"string\u003cdate-time>"},"departureTerminal":{"maxLength":20,"type":"string","description":"Airport departure terminal","uniqueKey":"semanticTagOverrides.departureTerminal","typeLabel":"string"},"membershipProgramName":{"type":"string","description":"Name of the membership or loyalty program","uniqueKey":"semanticTagOverrides.membershipProgramName","typeLabel":"string"},"transitProvider":{"type":"string","description":"Transit company or provider name","uniqueKey":"semanticTagOverrides.transitProvider","typeLabel":"string"},"departureLocation":{"required":["latitude","longitude"],"type":"object","properties":{"latitude":{"maximum":90,"minimum":-90,"type":"number","description":"Latitude in decimal degrees","isRequired":true,"uniqueKey":"semanticTagOverrides.departureLocation.latitude","typeLabel":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number","description":"Longitude in decimal degrees","isRequired":true,"uniqueKey":"semanticTagOverrides.departureLocation.longitude","typeLabel":"number"}},"additionalProperties":false,"description":"Departure location coordinates for transit passes","uniqueKey":"semanticTagOverrides.departureLocation","typeLabel":"object"},"flightCode":{"type":"string","description":"Airline IATA code (e.g., AA for American Airlines)","uniqueKey":"semanticTagOverrides.flightCode","typeLabel":"string"},"transitStatusReason":{"type":"string","description":"Reason for transit status if delayed or canceled","uniqueKey":"semanticTagOverrides.transitStatusReason","typeLabel":"string"},"venueGatesOpenDate":{"type":"string","description":"When the venue gates open","format":"date-time","uniqueKey":"semanticTagOverrides.venueGatesOpenDate","typeLabel":"string\u003cdate-time>"},"venueEntranceDoor":{"type":"string","description":"","uniqueKey":"semanticTagOverrides.venueEntranceDoor","typeLabel":"string"},"performerNames":{"type":"array","description":"List of performer names","items":{"type":"string","description":"Performer name","uniqueKey":"semanticTagOverrides.performerNames.items.[INDEX]","typeLabel":"string"},"uniqueKey":"semanticTagOverrides.performerNames","typeLabel":"string[]"},"venueDoorsOpenDate":{"type":"string","description":"","format":"date-time","uniqueKey":"semanticTagOverrides.venueDoorsOpenDate","typeLabel":"string\u003cdate-time>"},"transitStatus":{"type":"string","description":"Current transit status (e.g., On Time, Delayed)","uniqueKey":"semanticTagOverrides.transitStatus","typeLabel":"string"},"venueRegionName":{"type":"string","description":"","uniqueKey":"semanticTagOverrides.venueRegionName","typeLabel":"string"},"departureStationName":{"maxLength":100,"type":"string","description":"Departure station name","uniqueKey":"semanticTagOverrides.departureStationName","typeLabel":"string"},"homeTeamName":{"type":"string","description":"Home team full name","uniqueKey":"semanticTagOverrides.homeTeamName","typeLabel":"string"},"destinationStationName":{"maxLength":100,"type":"string","description":"Destination station name","uniqueKey":"semanticTagOverrides.destinationStationName","typeLabel":"string"},"venueCloseDate":{"type":"string","description":"","format":"date-time","uniqueKey":"semanticTagOverrides.venueCloseDate","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"description":"Semantic tags for Apple Wallet passes: seating, flight, event and location details that Wallet and Siri use for suggestions. All fields are optional; send the ones that apply to your pass type.","uniqueKey":"semanticTagOverrides","typeLabel":"object"},"membershipStatus":{"maxLength":255,"type":"string","description":"Merchant-defined account status (e.g., \"Active\", \"Suspended\", \"On Hold\")","uniqueKey":"membershipStatus","typeLabel":"string"},"externalReference":{"maxLength":200,"type":"string","description":"Additional external reference for integration with external systems","uniqueKey":"externalReference","typeLabel":"string"},"payload":{"type":"string","description":"NFC or QR payload (defaults to pass ID if not provided)","uniqueKey":"payload","typeLabel":"string"},"loyaltyState":{"type":"object","properties":{"memberSince":{"type":"string","description":"Date when customer became a member","format":"date-time","uniqueKey":"loyaltyState.memberSince","typeLabel":"string\u003cdate-time>"},"stampsCollected":{"type":"integer","description":"Number of stamps collected","uniqueKey":"loyaltyState.stampsCollected","typeLabel":"integer"},"terms":{"type":"string","description":"Terms and conditions text for the pass","uniqueKey":"loyaltyState.terms","typeLabel":"string"},"pointsBalance":{"type":"integer","description":"Current loyalty points balance","uniqueKey":"loyaltyState.pointsBalance","typeLabel":"integer"},"voucherBalance":{"type":"number","description":"Total monetary value of active vouchers","uniqueKey":"loyaltyState.voucherBalance","typeLabel":"number"},"description":{"type":"string","description":"General description text for the pass (e.g., reward details)","uniqueKey":"loyaltyState.description","typeLabel":"string"},"voucherCurrency":{"type":"string","description":"Currency code for voucher balance (e.g., NOK)","uniqueKey":"loyaltyState.voucherCurrency","typeLabel":"string"},"currentTierId":{"type":"string","description":"Current tier identifier in loyalty program","uniqueKey":"loyaltyState.currentTierId","typeLabel":"string"},"pendingPoints":{"type":"integer","description":"Points pending activation (not yet redeemable)","uniqueKey":"loyaltyState.pendingPoints","typeLabel":"integer"},"voucherCount":{"type":"integer","description":"Number of active vouchers","uniqueKey":"loyaltyState.voucherCount","typeLabel":"integer"},"expirationDate":{"type":"string","description":"Loyalty membership expiration date","format":"date-time","uniqueKey":"loyaltyState.expirationDate","typeLabel":"string\u003cdate-time>"}},"description":"Loyalty program state information","uniqueKey":"loyaltyState","typeLabel":"object"},"attribution":{"type":"object","properties":{"referrerHost":{"maxLength":253,"type":"string","description":"Referrer host only, never a full URL","uniqueKey":"attribution.referrerHost","typeLabel":"string"},"reference":{"maxLength":200,"type":"string","description":"Opaque correlation id: request id, endpoint id, session id","uniqueKey":"attribution.reference","typeLabel":"string"},"origin":{"type":"string","description":"STELL = a Stell-hosted surface, MERCHANT = the merchant's own code calling the API (default), PARTNER = a third-party connector acting for the merchant","enum":["STELL","MERCHANT","PARTNER"],"uniqueKey":"attribution.origin","typeLabel":"enum\u003cstring>"},"channel":{"type":"string","description":"Where the person came from. When omitted it is DECLARED from campaign.medium (email, sms, qr, print, terminal, social, paid, push, web) or otherwise INFERRED from the mechanism.","enum":["EMAIL","SMS","QR","PRINT","TERMINAL","SOCIAL","PAID","PUSH","WEB","DIRECT","UNKNOWN"],"uniqueKey":"attribution.channel","typeLabel":"enum\u003cstring>"},"campaign":{"type":"object","properties":{"campaign":{"maxLength":200,"type":"string","uniqueKey":"attribution.campaign.campaign","typeLabel":"string"},"term":{"maxLength":200,"type":"string","uniqueKey":"attribution.campaign.term","typeLabel":"string"},"source":{"maxLength":200,"type":"string","uniqueKey":"attribution.campaign.source","typeLabel":"string"},"medium":{"maxLength":200,"type":"string","uniqueKey":"attribution.campaign.medium","typeLabel":"string"},"content":{"maxLength":200,"type":"string","uniqueKey":"attribution.campaign.content","typeLabel":"string"}},"additionalProperties":false,"description":"utm_* parameters as received","uniqueKey":"attribution.campaign","typeLabel":"object"},"mechanism":{"type":"string","description":"How the pass was created. Named for what happened, never for which system did it.","enum":["API","VAS_PERSONALIZATION","VAS_MEMBER_LINK","ADMIN_FORM","PORTAL_ISSUE","ONBOARDING_FORM","ONBOARDING_FORM_OTP","ONBOARDING_FORM_IDENTITY","PREBOARDING_LINK","DIRECT_LINK","EMBED_WIDGET","APP_CLIP","APP","CRM_SYNC"],"uniqueKey":"attribution.mechanism","typeLabel":"enum\u003cstring>"},"channelConfidence":{"type":"string","description":"DECLARED when the channel came from utm_medium or the caller, INFERRED otherwise; PUSH is always DECLARED","enum":["DECLARED","INFERRED"],"uniqueKey":"attribution.channelConfidence","typeLabel":"enum\u003cstring>"},"landingPath":{"maxLength":200,"type":"string","description":"Landing route template (e.g. /p/{nanoId}/{memberId}), never a real id","uniqueKey":"attribution.landingPath","typeLabel":"string"},"identityProvider":{"pattern":"^[a-z0-9-]{1,50}$","type":"string","description":"Identity provider slug (e.g. vipps) the person authenticated with. Required with mechanism ONBOARDING_FORM_IDENTITY and rejected with 400 on any other mechanism.","uniqueKey":"attribution.identityProvider","typeLabel":"string"}},"additionalProperties":false,"description":"Attribution: whose surface created the pass (origin), how it was created (mechanism) and where the person came from (channel + campaign). Every field is optional; absent fields default to origin MERCHANT, mechanism API, channel inferred, reference = request id.","uniqueKey":"attribution","typeLabel":"object"},"activationDate":{"type":"string","description":"Date when the pass becomes active","format":"date-time","uniqueKey":"activationDate","typeLabel":"string\u003cdate-time>"},"customer":{"type":"object","properties":{"firstName":{"type":"string","description":"Customer first name for personalization","uniqueKey":"customer.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Customer last name for personalization","uniqueKey":"customer.lastName","typeLabel":"string"},"emailAddress":{"type":"string","description":"Customer email address for notifications","format":"email","uniqueKey":"customer.emailAddress","typeLabel":"string\u003cemail>"},"personalId":{"maxLength":64,"type":"string","description":"National/personal identity number (e.g., Swedish personnummer). Optional. PII — sent only when required by merchant.","uniqueKey":"customer.personalId","typeLabel":"string"},"lookupSource":{"maxLength":50,"pattern":"^[a-z0-9-]+$","type":"string","description":"Which CRM was queried for new/existing determination (e.g., \"voyado\", \"bloomreach\"). Slug format.","uniqueKey":"customer.lookupSource","typeLabel":"string"},"phone":{"type":"string","description":"Customer phone number (deprecated - use mobileNumber)","uniqueKey":"customer.phone","typeLabel":"string"},"mobileNumber":{"type":"string","description":"Customer mobile phone number for SMS delivery","uniqueKey":"customer.mobileNumber","typeLabel":"string"},"isNew":{"type":"boolean","description":"Whether the customer is new (not found in merchant CRM). Set at creation, immutable.","uniqueKey":"customer.isNew","typeLabel":"boolean"},"email":{"type":"string","description":"Customer email address (deprecated - use emailAddress)","format":"email","uniqueKey":"customer.email","typeLabel":"string\u003cemail>"}},"description":"Optional customer information for personalization","uniqueKey":"customer","typeLabel":"object"},"expirationDate":{"type":"string","description":"Date when the pass expires","format":"date-time","uniqueKey":"expirationDate","typeLabel":"string\u003cdate-time>"}},"description":"Data required to create a pass.","uniqueKey":"","typeLabel":"CreatePassModel · object"},"examples":{"Example":{"title":"Example","value":{"programId":"\u003cstring>","templateOverrides":{"logoText":"\u003cstring>","fieldOverrides":{"backFields":[{"value":"\u003cstring>","key":"\u003cstring>","label":"\u003cstring>"}],"secondaryFields":[{"value":"\u003cstring>","key":"\u003cstring>","label":"\u003cstring>"}],"mergeStrategy":"MERGE","primaryFields":[{"value":"\u003cstring>","key":"\u003cstring>","label":"\u003cstring>"}],"headerFields":[{"value":"\u003cstring>","key":"\u003cstring>","label":"\u003cstring>"}],"auxiliaryFields":[{"value":"\u003cstring>","key":"\u003cstring>","label":"\u003cstring>"}]},"images":{"footerImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"artworkImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"primaryLogoImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"venueMapImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"logoImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"iconImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"secondaryLogoImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"backgroundImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"stripImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"},"thumbnailImage":{"sourceUrl":"\u003cstring>","uploadId":"\u003cstring>"}},"overrideMetadata":{},"overrideReason":"\u003cstring>","maxDistance":2,"actions":{},"colors":{"backgroundColor":"\u003cstring>","foregroundColor":"\u003cstring>","stripColor":"\u003cstring>","labelColor":"\u003cstring>"}},"notificationMessage":"\u003cstring>","externalId":"\u003cstring>","semanticTagOverrides":{"eventLiveMessage":"\u003cstring>","leagueAbbreviation":"\u003cstring>","venuePhoneNumber":"\u003cstring>","priorityStatus":"\u003cstring>","tailgatingAllowed":true,"seats":[{"seatIdentifier":"\u003cstring>","seatType":"\u003cstring>","seatDescription":"\u003cstring>","seatSection":"\u003cstring>","seatRow":"\u003cstring>","seatAisle":"\u003cstring>","seatSectionColor":"\u003cstring>","seatNumber":"\u003cstring>","seatLevel":"\u003cstring>"}],"attendeeName":"\u003cstring>","leagueName":"\u003cstring>","securityScreening":"\u003cstring>","venueEntrance":"\u003cstring>","destinationGate":"\u003cstring>","playlistIDs":["\u003cstring>"],"eventName":"\u003cstring>","vehicleNumber":"\u003cstring>","airplay":[{"airPlayDeviceGroupToken":"\u003cstring>"}],"homeTeamLocation":"\u003cstring>","silenceRequested":true,"awayTeamAbbreviation":"\u003cstring>","departureAirportCode":"\u003cstring>","vehicleType":"\u003cstring>","departurePlatform":"\u003cstring>","awayTeamLocation":"\u003cstring>","destinationLocationDescription":"\u003cstring>","boardingSequenceNumber":"\u003cstring>","venueEntrancePortal":"\u003cstring>","additionalTicketAttributes":"\u003cstring>","destinationAirportName":"\u003cstring>","membershipProgramNumber":"\u003cstring>","venueOpenDate":"2023-11-07T05:31:56Z","admissionLevelAbbreviation":"\u003cstring>","currentBoardingDate":"2023-11-07T05:31:56Z","flightNumber":123,"artistIDs":["\u003cstring>"],"carNumber":"\u003cstring>","venueName":"\u003cstring>","confirmationNumber":"\u003cstring>","venueParkingLotsOpenDate":"2023-11-07T05:31:56Z","originalBoardingDate":"2023-11-07T05:31:56Z","awayTeamName":"\u003cstring>","albumIDs":["\u003cstring>"],"destinationPlatform":"\u003cstring>","homeTeamAbbreviation":"\u003cstring>","sportName":"\u003cstring>","departureAirportName":"\u003cstring>","wifiAccess":[{"password":"\u003cstring>","ssid":"\u003cstring>"}],"eventStartDate":"2023-11-07T05:31:56Z","passengerName":{"namePrefix":"\u003cstring>","familyName":"\u003cstring>","givenName":"\u003cstring>","nickname":"\u003cstring>","nameSuffix":"\u003cstring>","middleName":"\u003cstring>","phoneticRepresentation":"\u003cstring>"},"destinationAirportCode":"\u003cstring>","vehicleName":"\u003cstring>","entranceDescription":"\u003cstring>","departureGate":"\u003cstring>","venueEntranceGate":"\u003cstring>","venueRoom":"\u003cstring>","venueFanZoneOpenDate":"2023-11-07T05:31:56Z","venueBoxOfficeOpenDate":"2023-11-07T05:31:56Z","departureLocationDescription":"\u003cstring>","originalDepartureDate":"2023-11-07T05:31:56Z","duration":123,"boardingGroup":"\u003cstring>","currentDepartureDate":"2023-11-07T05:31:56Z","destinationTerminal":"\u003cstring>","genre":"\u003cstring>","airlineCode":"\u003cstring>","currentArrivalDate":"2023-11-07T05:31:56Z","admissionLevel":"\u003cstring>","originalArrivalDate":"2023-11-07T05:31:56Z","eventEndDate":"2023-11-07T05:31:56Z","departureTerminal":"\u003cstring>","membershipProgramName":"\u003cstring>","transitProvider":"\u003cstring>","flightCode":"\u003cstring>","transitStatusReason":"\u003cstring>","venueGatesOpenDate":"2023-11-07T05:31:56Z","venueEntranceDoor":"\u003cstring>","performerNames":["\u003cstring>"],"venueDoorsOpenDate":"2023-11-07T05:31:56Z","transitStatus":"\u003cstring>","venueRegionName":"\u003cstring>","departureStationName":"\u003cstring>","homeTeamName":"\u003cstring>","destinationStationName":"\u003cstring>","venueCloseDate":"2023-11-07T05:31:56Z"},"membershipStatus":"\u003cstring>","externalReference":"\u003cstring>","payload":"\u003cstring>","loyaltyState":{"memberSince":"2023-11-07T05:31:56Z","stampsCollected":123,"terms":"\u003cstring>","pointsBalance":123,"voucherBalance":123,"description":"\u003cstring>","voucherCurrency":"\u003cstring>","currentTierId":"\u003cstring>","pendingPoints":123,"voucherCount":123,"expirationDate":"2023-11-07T05:31:56Z"},"attribution":{"referrerHost":"\u003cstring>","reference":"\u003cstring>","campaign":{"campaign":"\u003cstring>","term":"\u003cstring>","source":"\u003cstring>","medium":"\u003cstring>","content":"\u003cstring>"},"landingPath":"\u003cstring>","identityProvider":"\u003cstring>"},"activationDate":"2023-11-07T05:31:56Z","customer":{"firstName":"\u003cstring>","lastName":"\u003cstring>","emailAddress":"jsmith@example.com","personalId":"\u003cstring>","lookupSource":"\u003cstring>","phone":"\u003cstring>","mobileNumber":"\u003cstring>","isNew":true,"email":"jsmith@example.com"},"expirationDate":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"required":true,"description":"Pass details","exampleType":"generated"},"responses":{"ff4b93b1-5062-4d37-b854-94d972fb2811":{"description":"Pass created successfully.","content":{"application/json":{"schema":{"title":"PassResponseModel","required":["data","requestId"],"type":"object","properties":{"data":{"title":"PassModel","required":["createdAt","id","programId","status","updatedAt"],"type":"object","properties":{"createdAt":{"type":"string","description":"When the pass was created","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"id":{"pattern":"^pass-[0-9a-f-]+$","type":"string","description":"Unique pass identifier","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"updatedAt":{"type":"string","description":"When the pass was last updated","format":"date-time","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"programId":{"type":"string","description":"ID of the program this pass belongs to","isRequired":true,"uniqueKey":"data.programId","typeLabel":"string"},"status":{"type":"string","description":"Current pass status","enum":["PREACTIVE","ACTIVE","INACTIVE","VOIDED","REVOKED","EXPIRED"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"lastName":{"type":"string","description":"Deprecated pass-level last name — use customer.lastName","uniqueKey":"data.lastName","typeLabel":"string"},"walletLink":{"required":["url"],"type":"object","properties":{"url":{"type":"string","description":"The applicable wallet link: a pre-signed .pkpass download URL, an Apple Account binding secure URL, or a Google Wallet save link","format":"uri","isRequired":true,"uniqueKey":"data.walletLink.url","typeLabel":"string\u003curi>"},"expiresAt":{"type":"string","description":"Link expiration timestamp. Omitted when the link does not expire.","format":"date-time","uniqueKey":"data.walletLink.expiresAt","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"description":"The short-lived upstream wallet artifact. Only present on POST /v1/passes and PATCH /v1/passes/{passId} when includeWalletLink=true and generation succeeded. Prefer the permanent link field, which is always returned.","uniqueKey":"data.walletLink","typeLabel":"object"},"walletType":{"type":"string","description":"Wallet platform where pass is installed","x-extensible-enum":["APPLE_WALLET","GOOGLE_WALLET","SAMSUNG_WALLET","UNKNOWN"],"uniqueKey":"data.walletType","typeLabel":"string"},"companyName":{"maxLength":200,"type":"string","description":"Company name shown on the pass (employee passes)","uniqueKey":"data.companyName","typeLabel":"string"},"link":{"type":"string","description":"Permanent public link for the pass. Never expires, safe to print and email; resolves at open time to the applicable wallet action. Append ?delivery=direct to 302 straight to the wallet artifact (the .pkpass file for Apple Wallet, the save link for Google Wallet) instead of the landing page.","format":"uri","uniqueKey":"data.link","typeLabel":"string\u003curi>"},"employeeStartDate":{"type":"string","description":"Employee start date shown on the pass (employee passes)","format":"date-time","uniqueKey":"data.employeeStartDate","typeLabel":"string\u003cdate-time>"},"idNumber":{"maxLength":50,"type":"string","description":"National/personal identity number shown on the pass","uniqueKey":"data.idNumber","typeLabel":"string"},"entryState":{"type":"object","additionalProperties":true,"description":"Entry-related state data","uniqueKey":"data.entryState","typeLabel":"object"},"expiredAt":{"type":"string","description":"When the pass expired","format":"date-time","uniqueKey":"data.expiredAt","typeLabel":"string\u003cdate-time>"},"nfcPayload":{"maxLength":64,"type":"string","description":"NFC payload string","uniqueKey":"data.nfcPayload","typeLabel":"string"},"email":{"type":"string","description":"Deprecated pass-level email address — use customer.emailAddress","format":"email","uniqueKey":"data.email","typeLabel":"string\u003cemail>"},"group":{"type":"string","description":"Grouping identifier for related passes","uniqueKey":"data.group","typeLabel":"string"},"expirationDate":{"type":"string","description":"Scheduled date when the pass expires","format":"date-time","uniqueKey":"data.expirationDate","typeLabel":"string\u003cdate-time>"},"image":{"type":"string","description":"Pass image reference","uniqueKey":"data.image","typeLabel":"string"},"entryType":{"type":"string","description":"Entry rule type for access passes","enum":["timeBased","visitBased"],"uniqueKey":"data.entryType","typeLabel":"enum\u003cstring>"},"qrPayload":{"maxLength":4296,"type":"string","description":"QR code payload string","uniqueKey":"data.qrPayload","typeLabel":"string"},"creationSource":{"type":"object","properties":{"reference":{"type":"string","description":"Optional transaction/request ID","uniqueKey":"data.creationSource.reference","typeLabel":"string"},"method":{"type":"string","description":"Specific method/endpoint/action used","uniqueKey":"data.creationSource.method","typeLabel":"string"},"type":{"type":"string","description":"Creation method type","enum":["APPLE_VAS","API","MANUAL","BULK","CRM"],"uniqueKey":"data.creationSource.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"description":"Deprecated: legacy creation-source tracking, present only on passes created before attribution existed. Read attribution instead.","uniqueKey":"data.creationSource","typeLabel":"object"},"templateOverrides":{"type":"object","additionalProperties":true,"description":"Per-pass overrides of template fields and images","uniqueKey":"data.templateOverrides","typeLabel":"object"},"externalId":{"type":"string","description":"External system reference (e.g., CRM user ID)","uniqueKey":"data.externalId","typeLabel":"string"},"semanticTags":{"type":"object","properties":{"eventLiveMessage":{"maxLength":500,"type":"string","description":"Real-time event status updates (iOS 18+)","uniqueKey":"data.semanticTags.eventLiveMessage","typeLabel":"string"},"leagueAbbreviation":{"type":"string","description":"Sports league abbreviation (e.g., NFL, MLB)","uniqueKey":"data.semanticTags.leagueAbbreviation","typeLabel":"string"},"venuePhoneNumber":{"type":"string","description":"Venue contact phone number","uniqueKey":"data.semanticTags.venuePhoneNumber","typeLabel":"string"},"priorityStatus":{"type":"string","description":"Priority boarding or check-in status","uniqueKey":"data.semanticTags.priorityStatus","typeLabel":"string"},"tailgatingAllowed":{"type":"boolean","description":"","uniqueKey":"data.semanticTags.tailgatingAllowed","typeLabel":"boolean"},"seats":{"maxItems":10,"type":"array","description":"Seat assignments for events, flights, or venues","items":{"type":"object","properties":{"seatIdentifier":{"maxLength":50,"type":"string","description":"Unique seat identifier combining all components","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatIdentifier","typeLabel":"string"},"seatType":{"maxLength":30,"type":"string","description":"Type or category of seat","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatType","typeLabel":"string"},"seatDescription":{"maxLength":100,"type":"string","description":"Additional seat information","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatDescription","typeLabel":"string"},"seatSection":{"maxLength":20,"type":"string","description":"Section identifier (e.g., Orchestra, Balcony, A)","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatSection","typeLabel":"string"},"seatRow":{"maxLength":10,"type":"string","description":"Row identifier (e.g., 12, A, Front)","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatRow","typeLabel":"string"},"seatAisle":{"maxLength":10,"type":"string","description":"Aisle identifier","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatAisle","typeLabel":"string"},"seatSectionColor":{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string","description":"Color code for section visualization","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatSectionColor","typeLabel":"string"},"seatNumber":{"maxLength":10,"type":"string","description":"Seat number or identifier","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatNumber","typeLabel":"string"},"seatLevel":{"maxLength":10,"type":"string","description":"Level or floor identifier","uniqueKey":"data.semanticTags.seats.items.[INDEX].seatLevel","typeLabel":"string"}},"additionalProperties":false,"description":"One seat assignment","uniqueKey":"data.semanticTags.seats.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.semanticTags.seats","typeLabel":"object[]"},"attendeeName":{"maxLength":100,"type":"string","description":"Full name of the attendee","uniqueKey":"data.semanticTags.attendeeName","typeLabel":"string"},"leagueName":{"type":"string","description":"Sports league full name","uniqueKey":"data.semanticTags.leagueName","typeLabel":"string"},"securityScreening":{"type":"string","description":"Security screening type (e.g., TSA PreCheck)","uniqueKey":"data.semanticTags.securityScreening","typeLabel":"string"},"venueEntrance":{"type":"string","description":"Venue entrance name or identifier","uniqueKey":"data.semanticTags.venueEntrance","typeLabel":"string"},"destinationGate":{"maxLength":10,"type":"string","description":"Arrival gate identifier","uniqueKey":"data.semanticTags.destinationGate","typeLabel":"string"},"balance":{"required":["amount","currencyCode"],"type":"object","properties":{"amount":{"pattern":"^\\d+(\\.\\d{1,2})?$","type":"string","description":"Amount as string for precision (e.g., \"150.75\")","isRequired":true,"uniqueKey":"data.semanticTags.balance.amount","typeLabel":"string"},"currencyCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","isRequired":true,"uniqueKey":"data.semanticTags.balance.currencyCode","typeLabel":"string"}},"additionalProperties":false,"description":"Account balance for loyalty programs or stored value cards","uniqueKey":"data.semanticTags.balance","typeLabel":"object"},"playlistIDs":{"type":"array","description":"List of playlist identifiers","items":{"type":"string","description":"Playlist identifier","uniqueKey":"data.semanticTags.playlistIDs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.semanticTags.playlistIDs","typeLabel":"string[]"},"eventName":{"maxLength":200,"type":"string","description":"Name of the event","uniqueKey":"data.semanticTags.eventName","typeLabel":"string"},"vehicleNumber":{"type":"string","description":"Vehicle or route number","uniqueKey":"data.semanticTags.vehicleNumber","typeLabel":"string"},"airplay":{"type":"array","description":"AirPlay device configuration","items":{"required":["airPlayDeviceGroupToken"],"type":"object","properties":{"airPlayDeviceGroupToken":{"type":"string","description":"Token for AirPlay device group identification","isRequired":true,"uniqueKey":"data.semanticTags.airplay.items.[INDEX].airPlayDeviceGroupToken","typeLabel":"string"}},"description":"One AirPlay device","uniqueKey":"data.semanticTags.airplay.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.semanticTags.airplay","typeLabel":"object[]"},"homeTeamLocation":{"type":"string","description":"Home team city or location","uniqueKey":"data.semanticTags.homeTeamLocation","typeLabel":"string"},"silenceRequested":{"type":"boolean","description":"Whether silent mode is requested for notifications","uniqueKey":"data.semanticTags.silenceRequested","typeLabel":"boolean"},"awayTeamAbbreviation":{"maxLength":10,"type":"string","description":"Away team abbreviation for sports events","uniqueKey":"data.semanticTags.awayTeamAbbreviation","typeLabel":"string"},"departureAirportCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"IATA departure airport code","uniqueKey":"data.semanticTags.departureAirportCode","typeLabel":"string"},"vehicleType":{"type":"string","description":"Type of vehicle (e.g., Bus, Train, Ferry)","uniqueKey":"data.semanticTags.vehicleType","typeLabel":"string"},"departurePlatform":{"maxLength":20,"type":"string","description":"Train departure platform","uniqueKey":"data.semanticTags.departurePlatform","typeLabel":"string"},"awayTeamLocation":{"maxLength":50,"type":"string","description":"Away team city or location","uniqueKey":"data.semanticTags.awayTeamLocation","typeLabel":"string"},"destinationLocationDescription":{"maxLength":100,"type":"string","description":"Descriptive destination location","uniqueKey":"data.semanticTags.destinationLocationDescription","typeLabel":"string"},"boardingSequenceNumber":{"maxLength":10,"type":"string","description":"Boarding sequence or position number","uniqueKey":"data.semanticTags.boardingSequenceNumber","typeLabel":"string"},"venueEntrancePortal":{"type":"string","description":"","uniqueKey":"data.semanticTags.venueEntrancePortal","typeLabel":"string"},"additionalTicketAttributes":{"maxLength":200,"type":"string","description":"Additional ticket features and benefits","uniqueKey":"data.semanticTags.additionalTicketAttributes","typeLabel":"string"},"destinationAirportName":{"maxLength":100,"type":"string","description":"Full destination airport name","uniqueKey":"data.semanticTags.destinationAirportName","typeLabel":"string"},"membershipProgramNumber":{"type":"string","description":"Member identification number","uniqueKey":"data.semanticTags.membershipProgramNumber","typeLabel":"string"},"venueOpenDate":{"type":"string","description":"When the venue opens","format":"date-time","uniqueKey":"data.semanticTags.venueOpenDate","typeLabel":"string\u003cdate-time>"},"eventType":{"type":"string","description":"Category of event this pass is for","enum":["PKEventTypeGeneric","PKEventTypeMovie","PKEventTypeConference","PKEventTypeConvention","PKEventTypeWorkshop","PKEventTypeSocialGathering","PKEventTypeSports","PKEventTypeLivePerformance"],"uniqueKey":"data.semanticTags.eventType","typeLabel":"enum\u003cstring>"},"admissionLevelAbbreviation":{"maxLength":10,"type":"string","description":"Short form of admission level","uniqueKey":"data.semanticTags.admissionLevelAbbreviation","typeLabel":"string"},"currentBoardingDate":{"type":"string","description":"Updated boarding date and time","format":"date-time","uniqueKey":"data.semanticTags.currentBoardingDate","typeLabel":"string\u003cdate-time>"},"flightNumber":{"type":"number","description":"Flight number without airline code","uniqueKey":"data.semanticTags.flightNumber","typeLabel":"number"},"artistIDs":{"type":"array","description":"List of artist identifiers","items":{"type":"string","description":"Artist identifier","uniqueKey":"data.semanticTags.artistIDs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.semanticTags.artistIDs","typeLabel":"string[]"},"carNumber":{"maxLength":20,"type":"string","description":"Train car or vehicle number","uniqueKey":"data.semanticTags.carNumber","typeLabel":"string"},"venueName":{"type":"string","description":"Name of the venue or location","uniqueKey":"data.semanticTags.venueName","typeLabel":"string"},"eventStartDateInfo":{"required":["date"],"type":"object","properties":{"date":{"type":"string","description":"Event start date in ISO 8601 format","isRequired":true,"uniqueKey":"data.semanticTags.eventStartDateInfo.date","typeLabel":"string"},"ignoreTimeComponents":{"type":"boolean","description":"Whether to ignore time components and use date only","uniqueKey":"data.semanticTags.eventStartDateInfo.ignoreTimeComponents","typeLabel":"boolean"},"timeZone":{"type":"string","description":"Time zone identifier (e.g., America/New_York)","uniqueKey":"data.semanticTags.eventStartDateInfo.timeZone","typeLabel":"string"}},"description":"Event start date with timezone control","uniqueKey":"data.semanticTags.eventStartDateInfo","typeLabel":"object"},"confirmationNumber":{"maxLength":50,"type":"string","description":"Booking or reservation confirmation number","uniqueKey":"data.semanticTags.confirmationNumber","typeLabel":"string"},"venueParkingLotsOpenDate":{"type":"string","description":"When the venue parking lots open","format":"date-time","uniqueKey":"data.semanticTags.venueParkingLotsOpenDate","typeLabel":"string\u003cdate-time>"},"originalBoardingDate":{"type":"string","description":"Originally scheduled boarding date and time","format":"date-time","uniqueKey":"data.semanticTags.originalBoardingDate","typeLabel":"string\u003cdate-time>"},"awayTeamName":{"maxLength":50,"type":"string","description":"Full away team name","uniqueKey":"data.semanticTags.awayTeamName","typeLabel":"string"},"albumIDs":{"type":"array","description":"List of album identifiers","items":{"type":"string","description":"Album identifier","uniqueKey":"data.semanticTags.albumIDs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.semanticTags.albumIDs","typeLabel":"string[]"},"destinationPlatform":{"maxLength":20,"type":"string","description":"Train arrival platform","uniqueKey":"data.semanticTags.destinationPlatform","typeLabel":"string"},"homeTeamAbbreviation":{"type":"string","description":"Home team abbreviation (e.g., NYY)","uniqueKey":"data.semanticTags.homeTeamAbbreviation","typeLabel":"string"},"sportName":{"type":"string","description":"Name of the sport","uniqueKey":"data.semanticTags.sportName","typeLabel":"string"},"departureAirportName":{"maxLength":100,"type":"string","description":"Full departure airport name","uniqueKey":"data.semanticTags.departureAirportName","typeLabel":"string"},"venueLocation":{"required":["latitude","longitude"],"type":"object","properties":{"latitude":{"maximum":90,"minimum":-90,"type":"number","description":"Latitude in decimal degrees","isRequired":true,"uniqueKey":"data.semanticTags.venueLocation.latitude","typeLabel":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number","description":"Longitude in decimal degrees","isRequired":true,"uniqueKey":"data.semanticTags.venueLocation.longitude","typeLabel":"number"}},"additionalProperties":false,"description":"Venue location coordinates for events and venues","uniqueKey":"data.semanticTags.venueLocation","typeLabel":"object"},"wifiAccess":{"type":"array","description":"WiFi network information","items":{"required":["password","ssid"],"type":"object","properties":{"password":{"type":"string","description":"WiFi network password","isRequired":true,"uniqueKey":"data.semanticTags.wifiAccess.items.[INDEX].password","typeLabel":"string"},"ssid":{"type":"string","description":"WiFi network name (SSID)","isRequired":true,"uniqueKey":"data.semanticTags.wifiAccess.items.[INDEX].ssid","typeLabel":"string"}},"description":"One WiFi network","uniqueKey":"data.semanticTags.wifiAccess.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.semanticTags.wifiAccess","typeLabel":"object[]"},"eventStartDate":{"type":"string","description":"When the event starts","format":"date-time","uniqueKey":"data.semanticTags.eventStartDate","typeLabel":"string\u003cdate-time>"},"passengerName":{"type":"object","properties":{"namePrefix":{"maxLength":10,"type":"string","description":"Name prefix (Mr., Ms., Dr., etc.)","uniqueKey":"data.semanticTags.passengerName.namePrefix","typeLabel":"string"},"familyName":{"maxLength":50,"type":"string","description":"Last name/surname","uniqueKey":"data.semanticTags.passengerName.familyName","typeLabel":"string"},"givenName":{"maxLength":50,"type":"string","description":"First name","uniqueKey":"data.semanticTags.passengerName.givenName","typeLabel":"string"},"nickname":{"maxLength":30,"type":"string","description":"Preferred name or nickname","uniqueKey":"data.semanticTags.passengerName.nickname","typeLabel":"string"},"nameSuffix":{"maxLength":10,"type":"string","description":"Name suffix (Jr., Sr., III, etc.)","uniqueKey":"data.semanticTags.passengerName.nameSuffix","typeLabel":"string"},"middleName":{"maxLength":30,"type":"string","description":"Middle name or initial","uniqueKey":"data.semanticTags.passengerName.middleName","typeLabel":"string"},"phoneticRepresentation":{"maxLength":100,"type":"string","description":"Phonetic spelling for pronunciation","uniqueKey":"data.semanticTags.passengerName.phoneticRepresentation","typeLabel":"string"}},"additionalProperties":false,"description":"Passenger name components for boarding passes","uniqueKey":"data.semanticTags.passengerName","typeLabel":"object"},"destinationAirportCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"IATA destination airport code","uniqueKey":"data.semanticTags.destinationAirportCode","typeLabel":"string"},"vehicleName":{"type":"string","description":"Name of the vehicle or service","uniqueKey":"data.semanticTags.vehicleName","typeLabel":"string"},"entranceDescription":{"maxLength":200,"type":"string","description":"Description of the entrance location (iOS 18+)","uniqueKey":"data.semanticTags.entranceDescription","typeLabel":"string"},"departureGate":{"maxLength":10,"type":"string","description":"Departure gate identifier","uniqueKey":"data.semanticTags.departureGate","typeLabel":"string"},"totalPrice":{"required":["amount","currencyCode"],"type":"object","properties":{"amount":{"pattern":"^\\d+(\\.\\d{1,2})?$","type":"string","description":"Amount as string for precision (e.g., \"29.99\")","isRequired":true,"uniqueKey":"data.semanticTags.totalPrice.amount","typeLabel":"string"},"currencyCode":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","isRequired":true,"uniqueKey":"data.semanticTags.totalPrice.currencyCode","typeLabel":"string"}},"additionalProperties":false,"description":"Total price for transactions or purchases","uniqueKey":"data.semanticTags.totalPrice","typeLabel":"object"},"venueEntranceGate":{"type":"string","description":"","uniqueKey":"data.semanticTags.venueEntranceGate","typeLabel":"string"},"venueRoom":{"type":"string","description":"Room or hall within the venue","uniqueKey":"data.semanticTags.venueRoom","typeLabel":"string"},"venueFanZoneOpenDate":{"type":"string","description":"When the venue fan zone opens","format":"date-time","uniqueKey":"data.semanticTags.venueFanZoneOpenDate","typeLabel":"string\u003cdate-time>"},"venueBoxOfficeOpenDate":{"type":"string","description":"","format":"date-time","uniqueKey":"data.semanticTags.venueBoxOfficeOpenDate","typeLabel":"string\u003cdate-time>"},"destinationLocation":{"required":["latitude","longitude"],"type":"object","properties":{"latitude":{"maximum":90,"minimum":-90,"type":"number","description":"Latitude in decimal degrees","isRequired":true,"uniqueKey":"data.semanticTags.destinationLocation.latitude","typeLabel":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number","description":"Longitude in decimal degrees","isRequired":true,"uniqueKey":"data.semanticTags.destinationLocation.longitude","typeLabel":"number"}},"additionalProperties":false,"description":"Destination location coordinates for transit passes","uniqueKey":"data.semanticTags.destinationLocation","typeLabel":"object"},"departureLocationDescription":{"maxLength":100,"type":"string","description":"Descriptive departure location","uniqueKey":"data.semanticTags.departureLocationDescription","typeLabel":"string"},"originalDepartureDate":{"type":"string","description":"Originally scheduled departure date and time","format":"date-time","uniqueKey":"data.semanticTags.originalDepartureDate","typeLabel":"string\u003cdate-time>"},"duration":{"type":"number","description":"Duration in seconds","uniqueKey":"data.semanticTags.duration","typeLabel":"number"},"boardingGroup":{"maxLength":20,"type":"string","description":"Flight boarding group identifier","uniqueKey":"data.semanticTags.boardingGroup","typeLabel":"string"},"currentDepartureDate":{"type":"string","description":"Updated departure date and time","format":"date-time","uniqueKey":"data.semanticTags.currentDepartureDate","typeLabel":"string\u003cdate-time>"},"destinationTerminal":{"maxLength":20,"type":"string","description":"Airport arrival terminal","uniqueKey":"data.semanticTags.destinationTerminal","typeLabel":"string"},"genre":{"type":"string","description":"Event genre or category","uniqueKey":"data.semanticTags.genre","typeLabel":"string"},"airlineCode":{"pattern":"^[A-Z0-9]{2,3}$","type":"string","description":"IATA airline code (2-3 characters)","uniqueKey":"data.semanticTags.airlineCode","typeLabel":"string"},"currentArrivalDate":{"type":"string","description":"Updated arrival date and time","format":"date-time","uniqueKey":"data.semanticTags.currentArrivalDate","typeLabel":"string\u003cdate-time>"},"admissionLevel":{"maxLength":50,"type":"string","description":"Access level or tier","uniqueKey":"data.semanticTags.admissionLevel","typeLabel":"string"},"originalArrivalDate":{"type":"string","description":"Originally scheduled arrival date and time","format":"date-time","uniqueKey":"data.semanticTags.originalArrivalDate","typeLabel":"string\u003cdate-time>"},"eventEndDate":{"type":"string","description":"When the event ends","format":"date-time","uniqueKey":"data.semanticTags.eventEndDate","typeLabel":"string\u003cdate-time>"},"departureTerminal":{"maxLength":20,"type":"string","description":"Airport departure terminal","uniqueKey":"data.semanticTags.departureTerminal","typeLabel":"string"},"membershipProgramName":{"type":"string","description":"Name of the membership or loyalty program","uniqueKey":"data.semanticTags.membershipProgramName","typeLabel":"string"},"transitProvider":{"type":"string","description":"Transit company or provider name","uniqueKey":"data.semanticTags.transitProvider","typeLabel":"string"},"departureLocation":{"required":["latitude","longitude"],"type":"object","properties":{"latitude":{"maximum":90,"minimum":-90,"type":"number","description":"Latitude in decimal degrees","isRequired":true,"uniqueKey":"data.semanticTags.departureLocation.latitude","typeLabel":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number","description":"Longitude in decimal degrees","isRequired":true,"uniqueKey":"data.semanticTags.departureLocation.longitude","typeLabel":"number"}},"additionalProperties":false,"description":"Departure location coordinates for transit passes","uniqueKey":"data.semanticTags.departureLocation","typeLabel":"object"},"flightCode":{"type":"string","description":"Airline IATA code (e.g., AA for American Airlines)","uniqueKey":"data.semanticTags.flightCode","typeLabel":"string"},"transitStatusReason":{"type":"string","description":"Reason for transit status if delayed or canceled","uniqueKey":"data.semanticTags.transitStatusReason","typeLabel":"string"},"venueGatesOpenDate":{"type":"string","description":"When the venue gates open","format":"date-time","uniqueKey":"data.semanticTags.venueGatesOpenDate","typeLabel":"string\u003cdate-time>"},"venueEntranceDoor":{"type":"string","description":"","uniqueKey":"data.semanticTags.venueEntranceDoor","typeLabel":"string"},"performerNames":{"type":"array","description":"List of performer names","items":{"type":"string","description":"Performer name","uniqueKey":"data.semanticTags.performerNames.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.semanticTags.performerNames","typeLabel":"string[]"},"venueDoorsOpenDate":{"type":"string","description":"","format":"date-time","uniqueKey":"data.semanticTags.venueDoorsOpenDate","typeLabel":"string\u003cdate-time>"},"transitStatus":{"type":"string","description":"Current transit status (e.g., On Time, Delayed)","uniqueKey":"data.semanticTags.transitStatus","typeLabel":"string"},"venueRegionName":{"type":"string","description":"","uniqueKey":"data.semanticTags.venueRegionName","typeLabel":"string"},"departureStationName":{"maxLength":100,"type":"string","description":"Departure station name","uniqueKey":"data.semanticTags.departureStationName","typeLabel":"string"},"homeTeamName":{"type":"string","description":"Home team full name","uniqueKey":"data.semanticTags.homeTeamName","typeLabel":"string"},"destinationStationName":{"maxLength":100,"type":"string","description":"Destination station name","uniqueKey":"data.semanticTags.destinationStationName","typeLabel":"string"},"venueCloseDate":{"type":"string","description":"","format":"date-time","uniqueKey":"data.semanticTags.venueCloseDate","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"description":"Semantic tags for Apple Wallet passes: seating, flight, event and location details that Wallet and Siri use for suggestions. All fields are optional; send the ones that apply to your pass type.","uniqueKey":"data.semanticTags","typeLabel":"object"},"maxDistance":{"minimum":1,"type":"integer","description":"Maximum distance (meters) for Apple Wallet location notifications. Overrides template/program defaults.","uniqueKey":"data.maxDistance","typeLabel":"integer"},"isVoided":{"type":"boolean","description":"Whether the pass has been voided","uniqueKey":"data.isVoided","typeLabel":"boolean"},"membershipStatus":{"maxLength":255,"type":"string","description":"Merchant-defined account status (e.g., \"Active\", \"Suspended\", \"On Hold\")","uniqueKey":"data.membershipStatus","typeLabel":"string"},"externalReference":{"type":"string","description":"Additional external reference for integration with external systems","uniqueKey":"data.externalReference","typeLabel":"string"},"firstName":{"type":"string","description":"Deprecated pass-level first name — use customer.firstName","uniqueKey":"data.firstName","typeLabel":"string"},"googleWalletObjectId":{"type":"string","description":"Google Wallet object identifier for the pass","uniqueKey":"data.googleWalletObjectId","typeLabel":"string"},"phoneNumber":{"type":"string","description":"Deprecated pass-level phone number — use customer.mobileNumber","uniqueKey":"data.phoneNumber","typeLabel":"string"},"attribution":{"type":"object","properties":{"referrerHost":{"maxLength":253,"type":"string","description":"Referrer host only, never a full URL","uniqueKey":"data.attribution.referrerHost","typeLabel":"string"},"reference":{"maxLength":200,"type":"string","description":"Opaque correlation id: request id, endpoint id, session id","uniqueKey":"data.attribution.reference","typeLabel":"string"},"origin":{"type":"string","description":"STELL = a Stell-hosted surface, MERCHANT = the merchant's own code calling the API (default), PARTNER = a third-party connector acting for the merchant","enum":["STELL","MERCHANT","PARTNER"],"uniqueKey":"data.attribution.origin","typeLabel":"enum\u003cstring>"},"touchedAt":{"type":"string","description":"When the attribution was recorded (server-stamped)","format":"date-time","uniqueKey":"data.attribution.touchedAt","typeLabel":"string\u003cdate-time>"},"channel":{"type":"string","description":"Where the person came from. When omitted it is DECLARED from campaign.medium (email, sms, qr, print, terminal, social, paid, push, web) or otherwise INFERRED from the mechanism.","enum":["EMAIL","SMS","QR","PRINT","TERMINAL","SOCIAL","PAID","PUSH","WEB","DIRECT","UNKNOWN"],"uniqueKey":"data.attribution.channel","typeLabel":"enum\u003cstring>"},"campaign":{"type":"object","properties":{"campaign":{"maxLength":200,"type":"string","uniqueKey":"data.attribution.campaign.campaign","typeLabel":"string"},"term":{"maxLength":200,"type":"string","uniqueKey":"data.attribution.campaign.term","typeLabel":"string"},"source":{"maxLength":200,"type":"string","uniqueKey":"data.attribution.campaign.source","typeLabel":"string"},"medium":{"maxLength":200,"type":"string","uniqueKey":"data.attribution.campaign.medium","typeLabel":"string"},"content":{"maxLength":200,"type":"string","uniqueKey":"data.attribution.campaign.content","typeLabel":"string"}},"additionalProperties":false,"description":"utm_* parameters as received","uniqueKey":"data.attribution.campaign","typeLabel":"object"},"mechanism":{"type":"string","description":"How the pass was created. Named for what happened, never for which system did it.","enum":["API","VAS_PERSONALIZATION","VAS_MEMBER_LINK","ADMIN_FORM","PORTAL_ISSUE","ONBOARDING_FORM","ONBOARDING_FORM_OTP","ONBOARDING_FORM_IDENTITY","PREBOARDING_LINK","DIRECT_LINK","EMBED_WIDGET","APP_CLIP","APP","CRM_SYNC"],"uniqueKey":"data.attribution.mechanism","typeLabel":"enum\u003cstring>"},"channelConfidence":{"type":"string","description":"DECLARED when the channel came from utm_medium or the caller, INFERRED otherwise; PUSH is always DECLARED","enum":["DECLARED","INFERRED"],"uniqueKey":"data.attribution.channelConfidence","typeLabel":"enum\u003cstring>"},"landingPath":{"maxLength":200,"type":"string","description":"Landing route template (e.g. /p/{nanoId}/{memberId}), never a real id","uniqueKey":"data.attribution.landingPath","typeLabel":"string"},"identityProvider":{"pattern":"^[a-z0-9-]{1,50}$","type":"string","description":"Identity provider slug (e.g. vipps) the person authenticated with. Required with mechanism ONBOARDING_FORM_IDENTITY and rejected with 400 on any other mechanism.","uniqueKey":"data.attribution.identityProvider","typeLabel":"string"}},"additionalProperties":false,"description":"Attribution: whose surface created the pass (origin), how it was created (mechanism) and where the person came from (channel + campaign). Every field is optional; absent fields default to origin MERCHANT, mechanism API, channel inferred, reference = request id.","uniqueKey":"data.attribution","typeLabel":"object"},"loyaltyState":{"type":"object","additionalProperties":true,"description":"Loyalty program state data (points, stamps, tier, vouchers)","uniqueKey":"data.loyaltyState","typeLabel":"object"},"isExpired":{"type":"boolean","description":"Whether the pass has expired","uniqueKey":"data.isExpired","typeLabel":"boolean"},"activationDate":{"type":"string","description":"Scheduled date when the pass becomes active","format":"date-time","uniqueKey":"data.activationDate","typeLabel":"string\u003cdate-time>"},"voidedAt":{"type":"string","description":"When the pass was voided","format":"date-time","uniqueKey":"data.voidedAt","typeLabel":"string\u003cdate-time>"},"employeeRole":{"maxLength":100,"type":"string","description":"Employee role shown on the pass (employee passes)","uniqueKey":"data.employeeRole","typeLabel":"string"},"customer":{"type":"object","properties":{"firstName":{"type":"string","description":"Customer's first name","uniqueKey":"data.customer.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Customer's last name","uniqueKey":"data.customer.lastName","typeLabel":"string"},"emailAddress":{"type":"string","description":"Customer's email address","format":"email","uniqueKey":"data.customer.emailAddress","typeLabel":"string\u003cemail>"},"personalId":{"maxLength":64,"type":"string","description":"National/personal identity number (e.g., Swedish personnummer). Optional. PII — sent only when required by merchant.","uniqueKey":"data.customer.personalId","typeLabel":"string"},"lookupSource":{"maxLength":50,"pattern":"^[a-z0-9-]+$","type":"string","description":"Which CRM was queried for new/existing determination (e.g., \"voyado\", \"bloomreach\")","uniqueKey":"data.customer.lookupSource","typeLabel":"string"},"mobileNumber":{"type":"string","description":"Customer's mobile number in E.164 format","uniqueKey":"data.customer.mobileNumber","typeLabel":"string"},"isNew":{"type":"boolean","description":"Whether the customer was new (not found in merchant CRM) at pass creation time","uniqueKey":"data.customer.isNew","typeLabel":"boolean"}},"additionalProperties":false,"description":"Customer information","uniqueKey":"data.customer","typeLabel":"object"}},"description":"Digital pass issued to a customer.","isRequired":true,"uniqueKey":"data","typeLabel":"PassModel · object"},"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"description":"Response envelope carrying a pass.","uniqueKey":"","typeLabel":"PassResponseModel · object"},"examples":{"Example":{"title":"Example","value":{"data":{"createdAt":"2023-11-07T05:31:56Z","id":"\u003cstring>","updatedAt":"2023-11-07T05:31:56Z","programId":"\u003cstring>","status":"PREACTIVE","lastName":"\u003cstring>","walletLink":{"url":"\u003cstring>","expiresAt":"2023-11-07T05:31:56Z"},"walletType":"\u003cstring>","companyName":"\u003cstring>","link":"\u003cstring>","employeeStartDate":"2023-11-07T05:31:56Z","idNumber":"\u003cstring>","entryState":{},"expiredAt":"2023-11-07T05:31:56Z","nfcPayload":"\u003cstring>","email":"jsmith@example.com","group":"\u003cstring>","expirationDate":"2023-11-07T05:31:56Z","image":"\u003cstring>","entryType":"timeBased","qrPayload":"\u003cstring>","creationSource":{"reference":"\u003cstring>","method":"\u003cstring>","type":"APPLE_VAS"},"templateOverrides":{},"externalId":"\u003cstring>","semanticTags":{"eventLiveMessage":"\u003cstring>","leagueAbbreviation":"\u003cstring>","venuePhoneNumber":"\u003cstring>","priorityStatus":"\u003cstring>","tailgatingAllowed":true,"seats":[{"seatIdentifier":"\u003cstring>","seatType":"\u003cstring>","seatDescription":"\u003cstring>","seatSection":"\u003cstring>","seatRow":"\u003cstring>","seatAisle":"\u003cstring>","seatSectionColor":"\u003cstring>","seatNumber":"\u003cstring>","seatLevel":"\u003cstring>"}],"attendeeName":"\u003cstring>","leagueName":"\u003cstring>","securityScreening":"\u003cstring>","venueEntrance":"\u003cstring>","destinationGate":"\u003cstring>","balance":{"amount":"\u003cstring>","currencyCode":"\u003cstring>"},"playlistIDs":["\u003cstring>"],"eventName":"\u003cstring>","vehicleNumber":"\u003cstring>","airplay":[{"airPlayDeviceGroupToken":"\u003cstring>"}],"homeTeamLocation":"\u003cstring>","silenceRequested":true,"awayTeamAbbreviation":"\u003cstring>","departureAirportCode":"\u003cstring>","vehicleType":"\u003cstring>","departurePlatform":"\u003cstring>","awayTeamLocation":"\u003cstring>","destinationLocationDescription":"\u003cstring>","boardingSequenceNumber":"\u003cstring>","venueEntrancePortal":"\u003cstring>","additionalTicketAttributes":"\u003cstring>","destinationAirportName":"\u003cstring>","membershipProgramNumber":"\u003cstring>","venueOpenDate":"2023-11-07T05:31:56Z","eventType":"PKEventTypeGeneric","admissionLevelAbbreviation":"\u003cstring>","currentBoardingDate":"2023-11-07T05:31:56Z","flightNumber":123,"artistIDs":["\u003cstring>"],"carNumber":"\u003cstring>","venueName":"\u003cstring>","eventStartDateInfo":{"date":"\u003cstring>","ignoreTimeComponents":true,"timeZone":"\u003cstring>"},"confirmationNumber":"\u003cstring>","venueParkingLotsOpenDate":"2023-11-07T05:31:56Z","originalBoardingDate":"2023-11-07T05:31:56Z","awayTeamName":"\u003cstring>","albumIDs":["\u003cstring>"],"destinationPlatform":"\u003cstring>","homeTeamAbbreviation":"\u003cstring>","sportName":"\u003cstring>","departureAirportName":"\u003cstring>","venueLocation":{"latitude":0,"longitude":0},"wifiAccess":[{"password":"\u003cstring>","ssid":"\u003cstring>"}],"eventStartDate":"2023-11-07T05:31:56Z","passengerName":{"namePrefix":"\u003cstring>","familyName":"\u003cstring>","givenName":"\u003cstring>","nickname":"\u003cstring>","nameSuffix":"\u003cstring>","middleName":"\u003cstring>","phoneticRepresentation":"\u003cstring>"},"destinationAirportCode":"\u003cstring>","vehicleName":"\u003cstring>","entranceDescription":"\u003cstring>","departureGate":"\u003cstring>","totalPrice":{"amount":"\u003cstring>","currencyCode":"\u003cstring>"},"venueEntranceGate":"\u003cstring>","venueRoom":"\u003cstring>","venueFanZoneOpenDate":"2023-11-07T05:31:56Z","venueBoxOfficeOpenDate":"2023-11-07T05:31:56Z","destinationLocation":{"latitude":0,"longitude":0},"departureLocationDescription":"\u003cstring>","originalDepartureDate":"2023-11-07T05:31:56Z","duration":123,"boardingGroup":"\u003cstring>","currentDepartureDate":"2023-11-07T05:31:56Z","destinationTerminal":"\u003cstring>","genre":"\u003cstring>","airlineCode":"\u003cstring>","currentArrivalDate":"2023-11-07T05:31:56Z","admissionLevel":"\u003cstring>","originalArrivalDate":"2023-11-07T05:31:56Z","eventEndDate":"2023-11-07T05:31:56Z","departureTerminal":"\u003cstring>","membershipProgramName":"\u003cstring>","transitProvider":"\u003cstring>","departureLocation":{"latitude":0,"longitude":0},"flightCode":"\u003cstring>","transitStatusReason":"\u003cstring>","venueGatesOpenDate":"2023-11-07T05:31:56Z","venueEntranceDoor":"\u003cstring>","performerNames":["\u003cstring>"],"venueDoorsOpenDate":"2023-11-07T05:31:56Z","transitStatus":"\u003cstring>","venueRegionName":"\u003cstring>","departureStationName":"\u003cstring>","homeTeamName":"\u003cstring>","destinationStationName":"\u003cstring>","venueCloseDate":"2023-11-07T05:31:56Z"},"maxDistance":2,"isVoided":true,"membershipStatus":"\u003cstring>","externalReference":"\u003cstring>","firstName":"\u003cstring>","googleWalletObjectId":"\u003cstring>","phoneNumber":"\u003cstring>","attribution":{"referrerHost":"\u003cstring>","reference":"\u003cstring>","origin":"STELL","touchedAt":"2023-11-07T05:31:56Z","channel":"EMAIL","campaign":{"campaign":"\u003cstring>","term":"\u003cstring>","source":"\u003cstring>","medium":"\u003cstring>","content":"\u003cstring>"},"mechanism":"API","channelConfidence":"DECLARED","landingPath":"\u003cstring>","identityProvider":"\u003cstring>"},"loyaltyState":{},"isExpired":true,"activationDate":"2023-11-07T05:31:56Z","voidedAt":"2023-11-07T05:31:56Z","employeeRole":"\u003cstring>","customer":{"firstName":"\u003cstring>","lastName":"\u003cstring>","emailAddress":"jsmith@example.com","personalId":"\u003cstring>","lookupSource":"\u003cstring>","mobileNumber":"\u003cstring>","isNew":true}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1d574a6c-516a-4d02-9da3-0ecf8b0c4e6e":{"description":"Invalid request - missing required fields or invalid data","content":{"application/json":{"schema":{"title":"Error400Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["BAD_REQUEST","VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Invalid request parameters","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Bad request with validation details.","uniqueKey":"","typeLabel":"Error400Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"BAD_REQUEST","message":"Invalid request parameters","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d80606e1-6ecc-4399-bec5-0d548e93b7fa":{"description":"Authentication failed - invalid or missing API key","content":{"application/json":{"schema":{"title":"Error401Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["UNAUTHORIZED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Authentication required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Authentication failed.","uniqueKey":"","typeLabel":"Error401Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"UNAUTHORIZED","message":"Authentication required","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"e63db5e0-dde2-4f3f-b069-a80d3533a08e":{"description":"Access denied - program belongs to a different company","content":{"application/json":{"schema":{"title":"Error403Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["FORBIDDEN"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Access denied to this resource","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Access denied.","uniqueKey":"","typeLabel":"Error403Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"FORBIDDEN","message":"Access denied to this resource","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"1fb3819c-a7e2-4315-8262-83a267eeef01":{"description":"Program not found","content":{"application/json":{"schema":{"title":"Error404Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["NOT_FOUND"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Resource not found.","uniqueKey":"","typeLabel":"Error404Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"NOT_FOUND","message":"Resource not found","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ec0bd932-e23f-4187-9fc1-ecf4bbffb03f":{"description":"Internal server error","content":{"application/json":{"schema":{"title":"Error500Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"An internal server error occurred","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Internal server error.","uniqueKey":"","typeLabel":"Error500Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"INTERNAL_ERROR","message":"An internal server error occurred","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"dace5fa0-b974-41cd-8325-1b7cdef7e793":{"StellApiAuthorizer":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Include your API key as a Bearer token.\n\nExample: `Bearer sk_prod_xxxxxx`\n\nGet your API key from the Stell Dashboard.","scopes":[],"schemeName":"StellApiAuthorizer"}}},"servers":{"7cb07a26-83f2-4be3-9415-240d75b0dd81":{"url":"https://api.platform.getstell.com","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Include your API key as a Bearer token.\n\nExample: `Bearer sk_prod_xxxxxx`\n\nGet your API key from the Stell Dashboard.","scopes":[],"schemeName":"StellApiAuthorizer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication. Include your API key as a Bearer token.\n\nExample: `Bearer sk_prod_xxxxxx`\n\nGet your API key from the Stell Dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"StellApiAuthorizer","name":"Authorization"}],"title":"StellApiAuthorizer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"stell","siteName":"Stell","title":"Create new pass - Stell","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T21:57:13.941Z","originalFileLocation":"api-reference/passes/create-new-pass.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stell\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create new pass - Stell\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stell Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getstell.com/api-reference/passes/create-new-pass\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stell.mintlify.site/_mintlify/api/og/v2?division=Passes\u0026amp;title=Create+new+pass\u0026amp;description=Create+a+new+pass+for+a+program.+The+pass+is+created+in+PREACTIVE+status+and+includes+a+unique+authentication+token.+The+response+includes+the+permanent+link+fi\u0026amp;theme=d920f5eee51ec1647d160b3e\u0026amp;signature=9c4d592013c920a27dab2217eba3059862845d2f185323691e1b77ecb00207f4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create new pass - Stell\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stell.mintlify.site/_mintlify/api/og/v2?division=Passes\u0026amp;title=Create+new+pass\u0026amp;description=Create+a+new+pass+for+a+program.+The+pass+is+created+in+PREACTIVE+status+and+includes+a+unique+authentication+token.+The+response+includes+the+permanent+link+fi\u0026amp;theme=d920f5eee51ec1647d160b3e\u0026amp;signature=9c4d592013c920a27dab2217eba3059862845d2f185323691e1b77ecb00207f4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stell\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getstell.com/api-reference/passes/create-new-pass\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/passes/create-new-pass.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://getstell.com/#organization\",\"name\":\"Stell\",\"legalName\":\"Stell Tech AS\",\"url\":\"https://getstell.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://getstell.com/brand/stell-wordmark-navy.svg\"},\"sameAs\":[\"https://www.linkedin.com/company/stell-tech-as/\",\"https://www.youtube.com/@getstell\",\"https://github.com/Stell-Tech\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getstell.com#website\",\"name\":\"Stell\",\"url\":\"https://docs.getstell.com\",\"publisher\":{\"@id\":\"https://getstell.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getstell.com/api-reference/passes/create-new-pass#webpage\",\"url\":\"https://docs.getstell.com/api-reference/passes/create-new-pass\",\"name\":\"Create new pass\",\"description\":\"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.\",\"dateModified\":\"2026-11-03T21:57:13.941Z\",\"isPartOf\":{\"@id\":\"https://docs.getstell.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getstell.com/api-reference/passes/create-new-pass#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getstell.com/api-reference/passes/create-new-pass#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Passes\",\"item\":\"https://docs.getstell.com/api-reference/passes/get-pass-transactions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create new pass\",\"item\":\"https://docs.getstell.com/api-reference/passes/create-new-pass\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getstell.com/api-reference/passes/create-new-pass#apireference\",\"headline\":\"Create new pass\",\"name\":\"Create new pass\",\"description\":\"Create a new pass for a program. The pass is created in PREACTIVE status and includes a unique authentication token. The response includes the permanent link field for the pass.\",\"url\":\"https://docs.getstell.com/api-reference/passes/create-new-pass\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getstell.com/api-reference/passes/create-new-pass#webpage\"},\"dateModified\":\"2026-11-03T21:57:13.941Z\",\"publisher\":{\"@id\":\"https://getstell.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getstell.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stell\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Stell\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/passes/create-new-pass.md","siteName":"Stell","nav":{"global":null,"tabs":[{"tab":"Getting started","pages":[{"title":"Getting started","href":""}]},{"tab":"Merchant portal","pages":[{"title":"Merchant portal","href":"/programs/overview"}]},{"tab":"Launch \u0026 grow","pages":[{"title":"Launch \u0026 grow","href":"/launch-and-grow/overview"}]},{"tab":"API reference","groups":[{"group":"Essentials","pages":[{"title":"Stell API: issue Apple Wallet and Google Wallet passes","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"title":"Create and rotate Stell API keys","sidebarTitle":"API keys","href":"/api-reference/api-keys"},{"title":"Authenticate with the Stell API","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Stell API errors and status codes","sidebarTitle":"Errors","href":"/api-reference/errors"}]},{"group":"Integration guide","pages":[{"title":"Wallet pass API integration guide","sidebarTitle":"Integration overview","href":"/api-reference/integration/overview"},{"title":"Add to Apple Wallet and Google Wallet from your own site or app","sidebarTitle":"Add to Wallet","href":"/api-reference/integration/add-to-wallet"},{"title":"Update a wallet pass from your backend","sidebarTitle":"Updating a pass","href":"/api-reference/integration/updating-passes"},{"title":"Identify wallet pass holders at the POS: scan or NFC tap","sidebarTitle":"In-store: scan or tap","href":"/api-reference/integration/in-store"},{"title":"Wallet pass webhooks, lifecycle and go-live checklist","sidebarTitle":"Webhooks and go-live","href":"/api-reference/integration/go-live"}]},{"group":"Webhooks","pages":[{"title":"Event webhooks for wallet pass events","sidebarTitle":"Event webhooks","href":"/api-reference/webhooks/overview"},{"title":"Webhook deliveries: payloads, retries and signature verification","sidebarTitle":"Webhook deliveries","href":"/api-reference/webhooks/deliveries"}]},{"group":"Passes","pages":[{"title":"Get pass transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/transactions","href":"/api-reference/passes/get-pass-transactions"},{"title":"Get pass details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}","href":"/api-reference/passes/get-pass-details"},{"title":"Void pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/passes/{passId}","href":"/api-reference/passes/void-pass"},{"title":"Update pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/passes/{passId}","href":"/api-reference/passes/update-pass"},{"title":"Generate Google Wallet save link","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/links/google","href":"/api-reference/passes/generate-google-wallet-save-link"},{"title":"Create pass image upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes/image-uploads","href":"/api-reference/passes/create-pass-image-upload"},{"title":"List passes","description":"Returns passes for your company, newest first, with filtering and pagination. Results filtered by externalId, or by programId together with status, are not ordered by creation time. Any filter that is not a key of the index being queried (always email, phoneNumber and walletType; status and programId on some combinations) narrows each page after limit is applied, so a filtered page can hold fewer passes than limit (even none) while nextToken is still set: keep paginating until nextToken is absent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes","href":"/api-reference/passes/list-passes"},{"title":"Create new pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes","href":"/api-reference/passes/create-new-pass"},{"title":"Generate Apple Wallet installation link","description":"Generate a time-limited URL for adding the pass to Apple Wallet. Deprecated: prefer the permanent link field returned on every pass object, which never expires and resolves to the applicable wallet action for any wallet type.","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/links/apple","href":"/api-reference/passes/generate-apple-wallet-installation-link"},{"title":"Create secure Apple Wallet pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/apple/passes/secure","href":"/api-reference/passes/create-secure-apple-wallet-pass"},{"title":"Get pass registrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/registrations","href":"/api-reference/passes/get-pass-registrations"},{"title":"Batch create passes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes/batch","href":"/api-reference/passes/batch-create-passes"}]},{"group":"Pass Templates","pages":[{"title":"List all pass templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/templates","href":"/api-reference/pass-templates/list-all-pass-templates"},{"title":"Get program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}/templates/{templateId}","href":"/api-reference/pass-templates/get-program-pass-template"},{"title":"Delete program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/programs/{programId}/templates/{templateId}","href":"/api-reference/pass-templates/delete-program-pass-template"},{"title":"Update program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/programs/{programId}/templates/{templateId}","href":"/api-reference/pass-templates/update-program-pass-template"},{"title":"Get pass template details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/templates/{templateId}","href":"/api-reference/pass-templates/get-pass-template-details"},{"title":"List program pass templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}/templates","href":"/api-reference/pass-templates/list-program-pass-templates"},{"title":"Create program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/programs/{programId}/templates","href":"/api-reference/pass-templates/create-program-pass-template"}]},{"group":"Engagement","pages":[{"title":"Get pass geofences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/geofences","href":"/api-reference/engagement/get-pass-geofences"},{"title":"Replace all pass geofences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/passes/{passId}/geofences","href":"/api-reference/engagement/replace-all-pass-geofences"},{"title":"Add pass geofence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes/{passId}/geofences","href":"/api-reference/engagement/add-pass-geofence"},{"title":"Delete all pass geofences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/passes/{passId}/geofences","href":"/api-reference/engagement/delete-all-pass-geofences"},{"title":"Delete pass geofence by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/passes/{passId}/geofences/{geofenceId}","href":"/api-reference/engagement/delete-pass-geofence-by-id"},{"title":"Update pass geofence by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/passes/{passId}/geofences/{geofenceId}","href":"/api-reference/engagement/update-pass-geofence-by-id"}]},{"group":"Programs","pages":[{"title":"Get encryption key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}/encryption-key","href":"/api-reference/programs/get-encryption-key"},{"title":"List programs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs","href":"/api-reference/programs/list-programs"},{"title":"Create new program","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/programs","href":"/api-reference/programs/create-new-program"},{"title":"Get program details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}","href":"/api-reference/programs/get-program-details"},{"title":"Delete program","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/programs/{programId}","href":"/api-reference/programs/delete-program"},{"title":"Update program","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/programs/{programId}","href":"/api-reference/programs/update-program"}]},{"group":"Companies","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies","href":"/api-reference/companies/list-companies"},{"title":"Get company details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/{companyId}","href":"/api-reference/companies/get-company-details"}]},{"group":"Stores","pages":[{"title":"List stores","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/stores","href":"/api-reference/stores/list-stores"},{"title":"Create store","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/stores","href":"/api-reference/stores/create-store"},{"title":"Get store details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/stores/{storeId}","href":"/api-reference/stores/get-store-details"},{"title":"Delete store","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/stores/{storeId}","href":"/api-reference/stores/delete-store"},{"title":"Update store","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/stores/{storeId}","href":"/api-reference/stores/update-store"}]},{"group":"Merchants","pages":[{"title":"List merchants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/merchants","href":"/api-reference/merchants/list-merchants"},{"title":"Create merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/merchants","href":"/api-reference/merchants/create-merchant"},{"title":"Get merchant details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/merchants/{merchantId}","href":"/api-reference/merchants/get-merchant-details"},{"title":"Delete merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/merchants/{merchantId}","href":"/api-reference/merchants/delete-merchant"},{"title":"Update merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/merchants/{merchantId}","href":"/api-reference/merchants/update-merchant"}]},{"group":"Terminals","pages":[{"title":"Get terminal details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/terminals/{terminalId}","href":"/api-reference/terminals/get-terminal-details"},{"title":"Delete terminal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/terminals/{terminalId}","href":"/api-reference/terminals/delete-terminal"},{"title":"Update terminal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/terminals/{terminalId}","href":"/api-reference/terminals/update-terminal"},{"title":"List terminals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/terminals","href":"/api-reference/terminals/list-terminals"},{"title":"Create terminal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/terminals","href":"/api-reference/terminals/create-terminal"}]},{"group":"System","pages":[{"title":"JSON Web Key Set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /.well-known/jwks.json","href":"/api-reference/system/json-web-key-set"},{"title":"Health check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/health","href":"/api-reference/system/health-check"}]},{"group":"Transactions","pages":[{"title":"Get transaction details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/transactions/{transactionId}","href":"/api-reference/transactions/get-transaction-details"},{"title":"List transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Create transaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions","href":"/api-reference/transactions/create-transaction"}]}]}]},"basePath":"","title":"Create new pass - Stell","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}