Getgiftcardbypasssid

curl --request GET \
  --url https://api.loyalty.dog/v2/giftcards/passes/{passSid} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Gift Cards

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

GET

giftcards

passes

{passSid}

Getgiftcardbypasssid

curl --request GET \
  --url https://api.loyalty.dog/v2/giftcards/passes/{passSid} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

JWT access token obtained from POST /v2/token.

Path Parameters

passSid

string

required

Response

Successful Response

Giftcardhealthcheck Getgiftcards