> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loyalty.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Getgiftcardbypasssid

> ### Get Gift Card Info by Pass SID

Returns lightweight gift card information for the pass linked to the given `passSid`.
This endpoint is used by the public pass page to determine if a pass is linked to a
gift card and what state the card is in, so the appropriate UI screen can be shown.

**No customer session is required** — only HMAC authentication from the ambassador.

**Path Parameters**:
- `passSid`: The SID of the wallet pass

**Returns**:
- `id`: Gift card MongoDB ObjectId
- `programId`: The gift card program ID (required to call activate endpoint)
- `status`: Current card status (pending / active / expired / etc.)
- `lastFourDigits`: Last 4 digits of the card number
- `initialValue`: Face value of the card
- `balance`: Current balance
- `expiresAt`: Card expiry datetime
- `merchantName`: Name of the issuing merchant

**Status Codes**:
- 200: Gift card found
- 404: No gift card linked to this pass SID



## OpenAPI

````yaml https://api.loyalty.dog/openapi.json get /v2/giftcards/passes/{passSid}
openapi: 3.1.0
info:
  title: LoyaltyDog
  description: >-

    Welcome to the LoyaltyDog API! This API provides access to our loyalty
    program features, allowing you to integrate with various platforms and
    manage your loyalty data.


    Want to query LoyaltyDog via an AI assistant (Claude, Cursor, Windsurf)? See
    the [MCP Integration guide](https://loyaltydog.ai/playground#mcp).
        
  termsOfService: https://loyalty.dog/loyalty-program-terms-service
  contact:
    name: LoyaltyDog Support
    url: https://loyalty.dog/contact-us
    email: support@loyalty.dog
  version: 1.0.1
servers:
  - url: https://api.loyalty.dog
    description: Production
security:
  - bearerAuth: []
paths:
  /v2/giftcards/passes/{passSid}:
    get:
      tags:
        - Gift Cards
      summary: Getgiftcardbypasssid
      description: >-
        ### Get Gift Card Info by Pass SID


        Returns lightweight gift card information for the pass linked to the
        given `passSid`.

        This endpoint is used by the public pass page to determine if a pass is
        linked to a

        gift card and what state the card is in, so the appropriate UI screen
        can be shown.


        **No customer session is required** — only HMAC authentication from the
        ambassador.


        **Path Parameters**:

        - `passSid`: The SID of the wallet pass


        **Returns**:

        - `id`: Gift card MongoDB ObjectId

        - `programId`: The gift card program ID (required to call activate
        endpoint)

        - `status`: Current card status (pending / active / expired / etc.)

        - `lastFourDigits`: Last 4 digits of the card number

        - `initialValue`: Face value of the card

        - `balance`: Current balance

        - `expiresAt`: Card expiry datetime

        - `merchantName`: Name of the issuing merchant


        **Status Codes**:

        - 200: Gift card found

        - 404: No gift card linked to this pass SID
      operationId: getGiftCardByPassSid_v2_giftcards_passes__passSid__get
      parameters:
        - name: passSid
          in: path
          required: true
          schema:
            type: string
            title: Passsid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from POST /v2/token.

````