**版本：202601**

# 查询礼品卡详情

**GET** `/openapi/2026-01/gift_cards/:id`

通过礼品卡 ID 获取指定礼品卡的详情。

## 请求

**Path参数**

- `id` string (required)

  礼品卡 ID

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `gift_card` object

    礼品卡

    - `id` string

      礼品卡 ID
    - `last_characters` string

      礼品卡码的后四位
    - `balance` string

      礼品卡当前余额
    - `initial_value` string

      礼品卡的初始面值
    - `note` string

      附加在礼品卡上的备注
    - `expires_on` string

      礼品卡到期时间（如 2018-11-02T12:30:10Z）
    - `disabled_at` string

      礼品卡被禁用的时间（如 2018-11-02T12:30:10Z）
    - `enabled` boolean

      礼品卡当前是否已启用
    - `created_at` string

      礼品卡创建时间（如 2018-11-02T12:30:10Z）
    - `updated_at` string

      礼品卡最后更新时间（如 2018-11-02T12:30:10Z）
    - `status` string

      礼品卡状态：

      *   `enable`: 启用，礼品卡可正常使用
      *   `disable`: 禁用，礼品卡不可用
    - `currency` string

      礼品卡面值所使用的货币
    - `line_item_id` string

      与礼品卡关联的商品行项目 ID
    - `order_id` string

      与礼品卡关联的订单 ID
    - `user_id` string

      礼品卡创建者或所有者的用户 ID
    - `template_suffix` string

      用于在线渲染礼品卡的模板后缀
    - `customer_id` string

      与礼品卡关联的顾客 ID
    - `code` string

      礼品卡码，由字母数字字符组成（最少 8 个字符，最多 20 个字符）

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "gift_card": {
      "id": "string",
      "last_characters": "string",
      "balance": "string",
      "initial_value": "string",
      "note": "string",
      "expires_on": "string",
      "disabled_at": "string",
      "enabled": true,
      "created_at": "string",
      "updated_at": "string",
      "status": "string",
      "currency": "string",
      "line_item_id": "string",
      "order_id": "string",
      "user_id": "string",
      "template_suffix": "string",
      "customer_id": "string",
      "code": "string"
    }
  }
}
```