---
title: "Changes to Retrieve a gift card"
method: GET
path: "/gift_cards/{giftCardId}"
---

# Changes to Retrieve a gift card

`GET /gift_cards/{giftCardId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 23 breaking, 6 warning, 14 info

## Changes

- **2026-07-13** `859097ed3fe6`: 23 breaking, 6 warning, 14 info
  - the response property `data/attributes/balance_max_cents` became nullable for the status `200`
  - the response property `data/attributes/balance_max_float` became nullable for the status `200`
  - the response property `data/attributes/code` became nullable for the status `200`
  - the response property `data/attributes/currency_code` became nullable for the status `200`
  - the response property `data/attributes/expires_at` became nullable for the status `200`
  - the response property `data/attributes/formatted_balance_max` became nullable for the status `200`
  - the response property `data/attributes/image_url` became nullable for the status `200`
  - the response property `data/attributes/metadata` became nullable for the status `200`
  - the response property `data/attributes/rechargeable` became nullable for the status `200`
  - the response property `data/attributes/recipient_email` became nullable for the status `200`
  - the response property `data/attributes/reference` became nullable for the status `200`
  - the response property `data/attributes/reference_origin` became nullable for the status `200`
  - the response property `data/attributes/single_use` became nullable for the status `200`
  - the response property `data` became optional for the status `200`
  - the response property `data/attributes` became optional for the status `200`
  - the response property `data/type` became optional for the status `200`
  - the `data/attributes/balance_max_cents` response's property type changed from `string` to `integer, null` for status `200`
  - removed the required property `data/relationships/attachments/id` from the response with the `200` status
  - removed the required property `data/relationships/attachments/type` from the response with the `200` status
  - removed the required property `data/relationships/gift_card_recipient/id` from the response with the `200` status
  - removed the required property `data/relationships/gift_card_recipient/type` from the response with the `200` status
  - removed the required property `data/relationships/market/id` from the response with the `200` status
  - removed the required property `data/relationships/market/type` from the response with the `200` status
  - removed the optional property `data/attributes/id` from the response with the `200` status
  - added the new `active` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `draft` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `gift_cards` enum value to the `data/type` response property for the response status `200`
  - added the new `inactive` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `redeemed` enum value to the `data/attributes/status` response property for the response status `200`
  - added the optional property `data/attributes/distribute_discount` to the response with the `200` status
  - added the optional property `data/attributes/usage_log` to the response with the `200` status
  - added the optional property `data/id` to the response with the `200` status
  - added the optional property `data/links` to the response with the `200` status
  - added the optional property `data/relationships/attachments/data` to the response with the `200` status
  - added the optional property `data/relationships/attachments/links` to the response with the `200` status
  - added the optional property `data/relationships/event_stores` to the response with the `200` status
  - added the optional property `data/relationships/events` to the response with the `200` status
  - added the optional property `data/relationships/gift_card_recipient/data` to the response with the `200` status
  - added the optional property `data/relationships/gift_card_recipient/links` to the response with the `200` status
  - added the optional property `data/relationships/market/data` to the response with the `200` status
  - …3 more

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/gift_cards/:giftCardId/get.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/gift_cards/:giftCardId/get)