Skip to main content
Glama
gift_card.md2.86 kB
# gift_card A [gift card](https://help.shopify.com/manual/products/gift-card-products) that's been issued to a customer or a recipient. ## Properties | Property | Type | Description | |----------|------|-------------| | `balance` | number | "The remaining balance of the gift card in the currency's subunit." Expressed in presentment currency. For currencies without subunits (JPY, KRW), tenths and hundredths are appended. Apply money filters for formatted output. | | `code` | string | The redemption code for the gift card. | | `currency` | string | The [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code for the issued gift card. | | `customer` | customer | The customer object associated with the gift card. | | `enabled` | boolean | Indicates whether the gift card is active. | | `expired` | boolean | Indicates whether the gift card has expired. | | `expires_on` | string | "A timestamp for when the gift card expires." Returns `nil` if no expiration exists. Use the date filter for formatting. | | `initial_value` | number | "The initial balance of the gift card in the currency's subunit." Displayed in presentment currency with the same formatting rules as `balance`. | | `last_four_characters` | string | The final 4 characters of the redemption code. | | `message` | string | The personalized message for the recipient, or `nil` if absent. | | `pass_url` | string | URL to download the gift card as an Apple Wallet Pass. | | `product` | product | The product object associated with the gift card. | | `properties` | object | "The line item properties assigned to the gift card." Returns an `EmptyDrop` if none exist. | | `qr_identifier` | string | String value used to generate a QR code for the gift card. | | `recipient` | recipient | The recipient object, or `nil` if unassigned. | | `send_on` | string | "The scheduled date on which the gift card will be sent to the recipient," or `nil` if unscheduled. | | `template_suffix` | string | Name of the custom template assigned (without `gift_card.` prefix or `.liquid` extension), or `nil`. | | `url` | string | "The URL to view the gift card" on `checkout.shopify.com`, rendered via the gift_card.liquid template. | ## Example ```json { "balance": 5000, "code": "WCGX 7X97 K9HJ DFR8", "currency": "CAD", "customer": {}, "enabled": true, "expired": false, "expires_on": null, "initial_value": 5000, "last_four_characters": "DFR8", "message": null, "send_on": null, "pass_url": "https://polinas-potent-potions.myshopify.com/v1/passes/pass.com.shopify.giftcardnext/94af7fbe55d010130df8d8bc4a338d36/", "product": {}, "properties": {}, "qr_identifier": "shopify-giftcard-v1-3TKWJKJBM3X7PBRK", "recipient": null, "template_suffix": null, "url": "https://checkout.shopify.com/gift_cards/56174706753/0011c591fc720d0a51b80cdb694f969e" } ```

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/florinel-chis/shopify-liquid-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server