---
title: "HistoryOfGiftCard"
description: "The history details of a single customer's gift cards."
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/member-system/objects/history-of-gift-card'
  md: 'https://developer.shopline.com/docs/storefront-api/member-system/objects/history-of-gift-card.md'
---
# HistoryOfGiftCard

The history details of a single customer's gift cards.

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`HistoryOfGiftCard`

## Fields

* `currentBalance`

  [UnsignedInt64](https://developer.shopline.com/docs/storefront-api/common/scalars/unsigned-int-64.md)

  The current remaining available gift card balance

* `orderCode`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The order number corresponding to this record

* `sceneType`

  [HistoryOfGiftCardSceneType](https://developer.shopline.com/docs/storefront-api/member-system/enums/history-of-gift-card-scene-type.md)

  Gift card change scenario type

* `updateValue`

  [UnsignedInt64](https://developer.shopline.com/docs/storefront-api/common/scalars/unsigned-int-64.md)

  The absolute value of the gift card amount updated this time.
  If updateValue < 0, the gift card balance is reduced.
  If updateValue > 0, the gift card balance is reduced.

* `updatedAt`

  [Date](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  The time when this record was updated

## Schema Definition

```graphql
type HistoryOfGiftCard { 
	currentBalance: UnsignedInt64
	orderCode: String
	sceneType: HistoryOfGiftCardSceneType
	updateValue: UnsignedInt64
	updatedAt: Date 
}
```

## Field from

* [GiftCardHistoryEdge](https://developer.shopline.com/docs/storefront-api/member-system/objects/gift-card-history-edge.md).node

  node information

* [GiftCardHistoryConnection](https://developer.shopline.com/docs/storefront-api/member-system/objects/gift-card-history-connection.md).nodes

  node list

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes).