> ## Documentation Index > Fetch the complete documentation index at: https://docs.getstell.com/llms.txt > Use this file to discover all available pages before exploring further. # Get pass transactions > Retrieve transaction history for a specific pass. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/passes/{passId}/transactions openapi: 3.0.1 info: title: Stell API description: >- Create and manage passes for Apple Wallet and Google Wallet. One API for loyalty programs, membership cards, tickets, and more. termsOfService: https://getstell.com/terms contact: name: Stell API Support url: https://getstell.com/about?topic=Technical%20Support#contact email: hello@getstell.com version: '2026-08-09T18:16:19Z' servers: - url: https://api.platform.getstell.com description: Production API security: - StellApiAuthorizer: [] tags: - name: Companies description: Manage companies at the top of your tenant hierarchy. - name: Merchants description: Manage brands and business units within companies. - name: Stores description: Manage store locations and customer touchpoints. - name: Programs description: Configure pass programs for loyalty, membership, tickets, and more. - name: Pass Templates description: Define pass design and field layouts. - name: Passes description: Issue and manage customer passes for Apple and Google Wallet. - name: Terminals description: Configure terminals for tap-to-scan functionality. - name: Transactions description: Track pass usage, purchases, and redemptions. - name: Engagement description: Geofences, notifications, and location-based engagement features. - name: System description: Health checks and service monitoring. paths: /v1/passes/{passId}/transactions: get: tags: - Passes summary: Get pass transactions description: Retrieve transaction history for a specific pass. operationId: getPassTransactions parameters: - name: passId in: path required: true schema: type: string responses: '200': description: 200 response content: application/json: schema: $ref: '#/components/schemas/TransactionListModel' '400': description: 400 response content: application/json: schema: $ref: '#/components/schemas/Error400Model' '401': description: 401 response content: application/json: schema: $ref: '#/components/schemas/Error401Model' '403': description: 403 response content: application/json: schema: $ref: '#/components/schemas/Error403Model' '404': description: 404 response content: application/json: schema: $ref: '#/components/schemas/Error404Model' '500': description: 500 response content: application/json: schema: $ref: '#/components/schemas/Error500Model' security: - StellApiAuthorizer: [] components: schemas: TransactionListModel: title: TransactionListModel Response required: - data - requestId type: object properties: data: required: - transactions type: object properties: nextToken: type: string description: >- Pagination cursor for fetching the next page, absent on the last page transactions: type: array description: The transactions in this page of results items: required: - createdAt - id - passId - storeId - transactionDate - type - updatedAt type: object properties: pointsSpent: type: number description: Loyalty points redeemed passId: type: string description: Associated pass ID instrument: type: string description: How the pass was presented at the terminal enum: - CARD - CASH - MOBILE - OTHER - APPLE_VAS - GOOGLE_SMART_TAP - NFC_TYPE_1 - NFC_TYPE_2 - NFC_TYPE_3 - NFC_TYPE_4 - NFC_TYPE_5 - MIFARE remainingUsesBefore: type: integer description: >- Remaining uses on the pass before this transaction was applied terminalId: type: string description: Terminal ID that processed transaction storeId: type: string description: Store ID where transaction occurred type: type: string description: Kind of transaction recorded enum: - PURCHASE - REDEMPTION - ADJUSTMENT - ACTIVATION - CHECK_IN - CHECK_OUT - SCAN_ONLY transactionDate: type: string description: When the transaction occurred format: date-time reference: type: string description: External transaction reference createdAt: type: string description: When the transaction was created format: date-time pointsEarned: type: number description: Loyalty points earned statusReason: type: string description: >- Human-readable reason for the status, present when denied or failed remainingUsesAfter: type: integer description: >- Remaining uses on the pass after this transaction was applied payment: type: object properties: amount: type: number description: Payment amount currency: type: string description: ISO 4217 currency code description: Payment details, present for PURCHASE transactions id: type: string description: Unique transaction identifier additionalData: type: object additionalProperties: true description: Merchant-defined metadata attached to the transaction status: type: string description: Outcome of the transaction enum: - APPROVED - DENIED - FAILED - PENDING updatedAt: type: string description: When the transaction was last updated format: date-time description: Page of transactions plus the pagination cursor requestId: pattern: ^[0-9A-Z]{26}$ type: string description: Unique request identifier for debugging Error400Model: title: Error400Model required: - error - requestId type: object properties: requestId: pattern: ^[0-9A-Z]{26}$ type: string description: Unique request identifier for debugging error: required: - code - message type: object properties: code: type: string description: Machine-readable error code enum: - BAD_REQUEST details: type: object additionalProperties: true description: Additional error context message: type: string description: Human-readable error message default: Invalid request parameters description: Error information description: Bad request with validation details. Error401Model: title: Error401Model required: - error - requestId type: object properties: requestId: pattern: ^[0-9A-Z]{26}$ type: string description: Unique request identifier for debugging error: required: - code - message type: object properties: code: type: string description: Machine-readable error code enum: - UNAUTHORIZED details: type: object additionalProperties: true description: Additional error context message: type: string description: Human-readable error message default: Authentication required description: Error information description: Authentication failed. Error403Model: title: Error403Model required: - error - requestId type: object properties: requestId: pattern: ^[0-9A-Z]{26}$ type: string description: Unique request identifier for debugging error: required: - code - message type: object properties: code: type: string description: Machine-readable error code enum: - FORBIDDEN details: type: object additionalProperties: true description: Additional error context message: type: string description: Human-readable error message default: Access denied to this resource description: Error information description: Access denied. Error404Model: title: Error404Model required: - error - requestId type: object properties: requestId: pattern: ^[0-9A-Z]{26}$ type: string description: Unique request identifier for debugging error: required: - code - message type: object properties: code: type: string description: Machine-readable error code enum: - NOT_FOUND details: type: object additionalProperties: true description: Additional error context message: type: string description: Human-readable error message default: Resource not found description: Error information description: Resource not found. Error500Model: title: Error500Model required: - error - requestId type: object properties: requestId: pattern: ^[0-9A-Z]{26}$ type: string description: Unique request identifier for debugging error: required: - code - message type: object properties: code: type: string description: Machine-readable error code enum: - INTERNAL_ERROR details: type: object additionalProperties: true description: Additional error context message: type: string description: Human-readable error message default: An internal server error occurred description: Error information description: Internal server error. securitySchemes: StellApiAuthorizer: type: http scheme: bearer bearerFormat: API Key description: |- API key authentication. Include your API key as a Bearer token. Example: `Bearer sk_prod_xxxxxx` Get your API key from the Stell Dashboard. ````