> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Gift Card

> Retrieve details of a specific gift card

<Note>
  This endpoint retrieves detailed information about a specific gift card, including balance, transaction history, and redemption details.
</Note>

## Authentication

This endpoint requires a valid API key with `gift_cards:read` permissions.

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the gift card
</ParamField>

### Response

Returns the gift card object if found.

<RequestExample>
  ```bash cURL theme={null}
  curl --location 'https://api.stateset.com/v1/gift-cards/gc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
  --header 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```javascript Node.js theme={null}
  const giftCard = await stateset.giftCards.retrieve(
    'gc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
  );
  ```

  ```python Python theme={null}
  gift_card = stateset.gift_cards.retrieve(
    'gc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
  )
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "gc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
    "object": "gift_card",
    "code": "GIFT-XMAS-A3B7C9D2",
    "type": "digital",
    "status": "active",
    "initial_balance": 5000,
    "current_balance": 3750,
    "currency": "USD",
    "recipient": {
      "email": "recipient@example.com",
      "name": "Jane Smith",
      "message": "Happy Birthday! Enjoy your shopping.",
      "delivery_date": "2024-02-14T09:00:00Z",
      "delivery_status": "delivered",
      "delivered_at": "2024-02-14T09:00:05Z"
    },
    "purchaser": {
      "customer_id": "cust_abc123",
      "email": "purchaser@example.com",
      "name": "John Doe"
    },
    "design": {
      "template_id": "tmpl_birthday_001",
      "theme": "birthday",
      "preview_url": "https://gift-cards.stateset.com/preview/gc_0901f083-aa1c-43c5-af5c-0a9d2fc64e30"
    },
    "validity": {
      "activated_at": "2024-02-14T09:00:05Z",
      "expires_at": "2025-02-14T23:59:59Z",
      "is_expired": false,
      "days_until_expiry": 328
    },
    "restrictions": {
      "product_ids": [],
      "category_ids": [],
      "exclude_sale_items": false,
      "minimum_purchase": null
    },
    "redemption_url": "https://shop.example.com/gift-card/GIFT-XMAS-A3B7C9D2",
    "order_id": "order_789012",
    "created_at": "2024-01-20T12:00:00Z",
    "updated_at": "2024-03-15T10:30:00Z",
    "transactions": [
      {
        "id": "txn_123",
        "type": "redemption",
        "amount": 750,
        "balance_after": 4250,
        "order_id": "order_456789",
        "created_at": "2024-03-01T14:20:00Z"
      },
      {
        "id": "txn_124",
        "type": "redemption",
        "amount": 500,
        "balance_after": 3750,
        "order_id": "order_567890",
        "created_at": "2024-03-15T10:30:00Z"
      }
    ],
    "metadata": {
      "campaign": "birthday_promo_2024"
    }
  }
  ```
</ResponseExample>