---
title: "Getgiftcardbypasssid"
method: GET
path: "/v2/giftcards/passes/{passSid}"
tags: ["Gift Cards"]
---

# Getgiftcardbypasssid

`GET /v2/giftcards/passes/{passSid}`

## Request

- Base URL: `https://api.loyalty.dog`
- URL: `https://api.loyalty.dog/v2/giftcards/passes/{passSid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/loyalty/apis/loyaltydog/docs/v2/giftcards/passes/:passSid/get.ts> (a function with typed inputs; its response is checked against the schema)

### 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

## Path parameters

- `passSid` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/loyalty/apis/loyaltydog.md) - [All operations](https://skmtc.dev/loyalty/apis/loyaltydog/llms.txt) - [OpenAPI document](https://skmtc.dev/loyalty/apis/loyaltydog/revisions/5803242b0551?raw)