**Version: 202601**

# Disable gift card

**POST** `/openapi/2026-01/gift_cards/:id/disable`

Disables a specific gift card using its unique ID.

## Request

**Path Parameters**

- `id` string (required)

  Gift card's unique ID

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `gift_card` object

    Gift card

    - `id` string

      Gift card ID
    - `last_characters` string

      Last four characters of the gift card code
    - `balance` string

      Current balance of the gift card
    - `initial_value` string

      The initial value of the gift card
    - `note` string

      Note attached to the gift card
    - `expires_on` string

      Expiration date of the gift card (e.g., 2018-11-02T12:30:10Z)
    - `disabled_at` string

      Time when the gift card was disabled (e.g., 2018-11-02T12:30:10Z)
    - `enabled` boolean

      Whether the gift card is currently enabled
    - `created_at` string

      Time when the gift card was created (e.g., 2018-11-02T12:30:10Z)
    - `updated_at` string

      Time when the gift card was last updated (e.g., 2018-11-02T12:30:10Z)
    - `status` string

      Status of the gift card:

      *   `enable`: gift card is active and usable
      *   `disable`: gift card is disabled and cannot be used
    - `currency` string

      Currency in which the gift card is denominated
    - `line_item_id` string

      ID of the line item associated with the gift card
    - `order_id` string

      ID of the order associated with the gift card
    - `user_id` string

      User ID of the creator or owner of the gift card
    - `template_suffix` string

      Suffix of the template used to render the gift card online
    - `customer_id` string

      Customer ID associated with the gift card
    - `code` string

      The gift card code, consisting of alphanumeric characters (minimum: 8 characters, maximum: 20 characters)

```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"
    }
  }
}
```