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

# List Gift Cards

> Get all gift cards

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `enabled`, `disabled` (`enabled` matches active gift cards)
</ParamField>

<ParamField query="code" type="string">
  Filter by gift card code (partial, case-insensitive match)
</ParamField>

<ParamField query="customer_id" type="string">
  Filter by the customer the gift card was issued to
</ParamField>

<ParamField query="page" type="number" default="1">
  Page number
</ParamField>

<ParamField query="limit" type="number" default="50">
  Items per page
</ParamField>

## Response

Returns the standard response envelope. The `data` object contains the
`gift_cards` array plus flat `total`, `page`, and `limit` fields.

Amounts (`initial_value`, `balance`) are expressed in the gift card's
currency units (decimal), not minor units. Availability is reported via the
`enabled` boolean.

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": null,
    "data": {
      "gift_cards": [
        {
          "id": "b2c1a0d9-7f3e-4a21-9c8b-5d6e7f8a9b0c",
          "gift_card_id": "b2c1a0d9-7f3e-4a21-9c8b-5d6e7f8a9b0c",
          "code": "GIFT-ABCD-1234-EFGH",
          "initial_value": 50,
          "balance": 35,
          "currency": "USD",
          "enabled": true,
          "disabled_at": null,
          "starts_at": "2024-01-15T10:30:00.000Z",
          "expires_on": "2025-01-15T00:00:00.000Z",
          "customer_id": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
          "order_id": null,
          "note": "Birthday gift",
          "created_at": "2024-01-15T10:30:00.000Z",
          "updated_at": "2024-01-20T08:00:00.000Z"
        }
      ],
      "total": 45,
      "page": 1,
      "limit": 50
    },
    "count": null,
    "pagination": null
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.