--- title: GiftCard - GraphQL Admin description: Represents an issued gift card. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard md: https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard.md --- # Gift​Card object Requires `read_gift_cards` access scope. Represents an issued gift card. ## Fields * balance [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) non-null The gift card's remaining balance. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time at which the gift card was created. * customer [Customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) The customer who will receive the gift card. * deactivated​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) The date and time at which the gift card was deactivated. * enabled [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the gift card is enabled. * expires​On [Date](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Date) The date at which the gift card will expire. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * initial​Value [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) non-null The initial value of the gift card. * last​Characters [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The final four characters of the gift card code. * masked​Code [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The gift card code. Everything but the final four characters is masked. * note [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The note associated with the gift card, which isn't visible to the customer. * order [Order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) The order associated with the gift card. This value is `null` if the gift card was issued manually. * recipient​Attributes [Gift​Card​Recipient](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardRecipient) The recipient who will receive the gift card. * template​Suffix [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The theme template used to render the gift card online. * transactions [Gift​Card​Transaction​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/GiftCardTransactionConnection) The transaction history of the gift card. * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time at which the gift card was updated. *** ## Map ### Fields and connections with this object * {}[CustomerMergePreviewDefaultFields.giftCards](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.giftCards) * <->[GiftCardConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/GiftCardConnection#returns-nodes) * {}[GiftCardCreditTransaction.giftCard](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardCreditTransaction#field-GiftCardCreditTransaction.fields.giftCard) * {}[GiftCardDebitTransaction.giftCard](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardDebitTransaction#field-GiftCardDebitTransaction.fields.giftCard) * {}[GiftCardEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardEdge#field-GiftCardEdge.fields.node) * ||-[GiftCardTransaction.giftCard](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/GiftCardTransaction#fields-giftCard) *** ## Queries * [gift​Card](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCard) query Returns a gift card resource by ID. * [gift​Cards](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCards) query Returns a list of gift cards. *** ## \GiftCard Queries ### Queried by * \[gift​Card](https://shopify.dev/docs/api/admin-graphql/latest/queries/GiftCard) * \[gift​Cards](https://shopify.dev/docs/api/admin-graphql/latest/queries/GiftCardConnection) *** ## Mutations * [gift​Card​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) mutation Create a gift card. * [gift​Card​Deactivate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) mutation Deactivate a gift card. A deactivated gift card cannot be used by a customer. A deactivated gift card cannot be re-enabled. * [gift​Card​Send​Notification​To​Customer](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToCustomer) mutation Send notification to the customer of a gift card. * [gift​Card​Send​Notification​To​Recipient](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToRecipient) mutation Send notification to the recipient of a gift card. * [gift​Card​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardUpdate) mutation Update a gift card. *** ## <\~> GiftCard Mutations ### Mutated by * <\~>[gift​Card​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) * <\~>[gift​Card​Deactivate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) * <\~>[gift​Card​Send​Notification​To​Customer](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToCustomer) * <\~>[gift​Card​Send​Notification​To​Recipient](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToRecipient) * <\~>[gift​Card​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardUpdate) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-GiftCard Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)