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

# Getgiftcardbypasssid

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

### 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.net/loyalty/apis/loyaltydog.md) · [All operations](https://skmtc.net/loyalty/apis/loyaltydog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loyalty/loyaltydog/revisions/42b7b22af2b6/schema)