GET
/
admin
/
gift-cards
cURL
curl '{backend_url}/admin/gift-cards' \
-H 'Authorization: Bearer {access_token}'
{
  "limit": 123,
  "offset": 123,
  "count": 123,
  "gift_cards": [
    {
      "line_item": {
        "id": "<string>",
        "title": "<string>",
        "subtitle": "<string>",
        "thumbnail": "<string>",
        "variant": {
          "prices": [
            {
              "id": "<any>",
              "title": "<any>",
              "currency_code": "<any>",
              "amount": "<any>",
              "raw_amount": "<any>",
              "min_quantity": "<any>",
              "max_quantity": "<any>",
              "price_set_id": "<any>",
              "created_at": "<any>",
              "updated_at": "<any>",
              "deleted_at": "<any>"
            }
          ],
          "id": "<string>",
          "title": "<string>",
          "sku": "<string>",
          "barcode": "<string>",
          "ean": "<string>",
          "upc": "<string>",
          "allow_backorder": true,
          "manage_inventory": true,
          "inventory_quantity": 123,
          "hs_code": "<string>",
          "origin_country": "<string>",
          "mid_code": "<string>",
          "material": "<string>",
          "weight": 123,
          "length": 123,
          "height": 123,
          "width": 123,
          "variant_rank": 123,
          "options": [
            {
              "id": "<any>",
              "value": "<any>",
              "option": "<any>",
              "option_id": "<any>",
              "metadata": "<any>",
              "created_at": "<any>",
              "updated_at": "<any>",
              "deleted_at": "<any>"
            }
          ],
          "product": {},
          "product_id": "<string>",
          "calculated_price": {
            "id": "<string>",
            "is_calculated_price_price_list": true,
            "is_calculated_price_tax_inclusive": true,
            "calculated_amount": 123,
            "calculated_amount_with_tax": 123,
            "calculated_amount_without_tax": 123,
            "is_original_price_price_list": true,
            "is_original_price_tax_inclusive": true,
            "original_amount": 123,
            "currency_code": "usd",
            "calculated_price": {},
            "original_price": {},
            "original_amount_with_tax": 123,
            "original_amount_without_tax": 123
          },
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "deleted_at": "2023-11-07T05:31:56Z",
          "metadata": {},
          "inventory_items": [
            {
              "id": "<any>",
              "variant_id": "<any>",
              "variant": "<any>",
              "inventory_item_id": "<any>",
              "inventory": "<any>"
            }
          ]
        },
        "variant_id": "<string>",
        "product": {
          "collection": {
            "id": "<string>",
            "title": "<string>",
            "handle": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z",
            "deleted_at": "2023-11-07T05:31:56Z",
            "products": [
              {
                "collection": {
                  "id": "<string>",
                  "title": "<string>",
                  "handle": "<string>",
                  "created_at": "2023-11-07T05:31:56Z",
                  "updated_at": "2023-11-07T05:31:56Z",
                  "deleted_at": "2023-11-07T05:31:56Z",
                  "products": [
                    {}
                  ],
                  "metadata": {}
                },
                "categories": [
                  {
                    "category_children": [
                      "<any>"
                    ],
                    "parent_category": {
                      "category_children": "<any>",
                      "parent_category": "<any>",
                      "products": "<any>",
                      "name": "<any>",
                      "description": "<any>",
                      "id": "<any>",
                      "metadata": "<any>",
                      "created_at": "<any>",
                      "updated_at": "<any>",
                      "handle": "<any>",
                      "deleted_at": "<any>",
                      "is_active": "<any>",
                      "is_internal": "<any>",
                      "rank": "<any>",
                      "parent_category_id": "<any>"
                    },
                    "products": [
                      "<any>"
                    ],
                    "name": "<string>",
                    "description": "<string>",
                    "id": "<string>",
                    "metadata": {},
                    "created_at": "2023-11-07T05:31:56Z",
                    "updated_at": "2023-11-07T05:31:56Z",
                    "handle": "<string>",
                    "deleted_at": "2023-11-07T05:31:56Z",
                    "is_active": true,
                    "is_internal": true,
                    "rank": 123,
                    "parent_category_id": "<string>"
                  }
                ],
                "variants": [
                  {}
                ],
                "type": {
                  "id": "<string>",
                  "value": "<string>",
                  "created_at": "2023-11-07T05:31:56Z",
                  "updated_at": "2023-11-07T05:31:56Z",
                  "deleted_at": "2023-11-07T05:31:56Z",
                  "metadata": {}
                },
                "tags": [
                  {
                    "id": "<string>",
                    "value": "<string>",
                    "created_at": "2023-11-07T05:31:56Z",
                    "updated_at": "2023-11-07T05:31:56Z",
                    "deleted_at": "2023-11-07T05:31:56Z",
                    "metadata": {}
                  }
                ],
                "length": 123,
                "title": "<string>",
                "status": "draft",
                "options": [
                  {
                    "id": "<string>",
                    "title": "<string>",
                    "product": {},
                    "product_id": "<string>",
                    "values": [
                      "<any>"
                    ],
                    "metadata": {},
                    "created_at": "2023-11-07T05:31:56Z",
                    "updated_at": "2023-11-07T05:31:56Z",
                    "deleted_at": "2023-11-07T05:31:56Z"
                  }
                ],
                "description": "<string>",
                "id": "<string>",
                "metadata": {},
                "created_at": "2023-11-07T05:31:56Z",
                "updated_at": "2023-11-07T05:31:56Z",
                "handle": "<string>",
                "subtitle": "<string>",
                "is_giftcard": true,
                "thumbnail": "<string>",
                "width": 123,
                "weight": 123,
                "height": 123,
                "origin_country": "<string>",
                "hs_code": "<string>",
                "mid_code": "<string>",
                "material": "<string>",
                "collection_id": "<string>",
                "type_id": "<string>",
                "images": [
                  {
                    "id": "<string>",
                    "url": "<string>",
                    "created_at": "2023-11-07T05:31:56Z",
                    "updated_at": "2023-11-07T05:31:56Z",
                    "deleted_at": "2023-11-07T05:31:56Z",
                    "metadata": {},
                    "rank": 123
                  }
                ],
                "discountable": true,
                "external_id": "<string>",
                "deleted_at": "2023-11-07T05:31:56Z"
              }
            ],
            "metadata": {}
          },
          "categories": [
            {
              "category_children": [
                "<any>"
              ],
              "parent_category": {},
              "products": [
                "<any>"
              ],
              "name": "<string>",
              "description": "<string>",
              "id": "<string>",
              "metadata": {},
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "handle": "<string>",
              "deleted_at": "2023-11-07T05:31:56Z",
              "is_active": true,
              "is_internal": true,
              "rank": 123,
              "parent_category_id": "<string>"
            }
          ],
          "sales_channels": [
            {
              "id": "<string>",
              "name": "<string>",
              "description": "<string>",
              "is_disabled": true,
              "metadata": {},
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z"
            }
          ],
          "variants": [
            {
              "prices": [
                {
                  "id": "<any>",
                  "title": "<any>",
                  "currency_code": "<any>",
                  "amount": "<any>",
                  "raw_amount": "<any>",
                  "min_quantity": "<any>",
                  "max_quantity": "<any>",
                  "price_set_id": "<any>",
                  "created_at": "<any>",
                  "updated_at": "<any>",
                  "deleted_at": "<any>"
                }
              ],
              "id": "<string>",
              "title": "<string>",
              "sku": "<string>",
              "barcode": "<string>",
              "ean": "<string>",
              "upc": "<string>",
              "allow_backorder": true,
              "manage_inventory": true,
              "inventory_quantity": 123,
              "hs_code": "<string>",
              "origin_country": "<string>",
              "mid_code": "<string>",
              "material": "<string>",
              "weight": 123,
              "length": 123,
              "height": 123,
              "width": 123,
              "variant_rank": 123,
              "options": [
                {
                  "id": "<any>",
                  "value": "<any>",
                  "option": "<any>",
                  "option_id": "<any>",
                  "metadata": "<any>",
                  "created_at": "<any>",
                  "updated_at": "<any>",
                  "deleted_at": "<any>"
                }
              ],
              "product": {},
              "product_id": "<string>",
              "calculated_price": {
                "id": "<string>",
                "is_calculated_price_price_list": true,
                "is_calculated_price_tax_inclusive": true,
                "calculated_amount": 123,
                "calculated_amount_with_tax": 123,
                "calculated_amount_without_tax": 123,
                "is_original_price_price_list": true,
                "is_original_price_tax_inclusive": true,
                "original_amount": 123,
                "currency_code": "usd",
                "calculated_price": {},
                "original_price": {},
                "original_amount_with_tax": 123,
                "original_amount_without_tax": 123
              },
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z",
              "metadata": {},
              "inventory_items": [
                {
                  "id": "<any>",
                  "variant_id": "<any>",
                  "variant": "<any>",
                  "inventory_item_id": "<any>",
                  "inventory": "<any>"
                }
              ]
            }
          ],
          "type": {
            "id": "<string>",
            "value": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z",
            "deleted_at": "2023-11-07T05:31:56Z",
            "metadata": {}
          },
          "tags": [
            {
              "id": "<string>",
              "value": "<string>",
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z",
              "metadata": {}
            }
          ],
          "length": 123,
          "title": "<string>",
          "status": "draft",
          "options": [
            {
              "id": "<string>",
              "title": "<string>",
              "product": {},
              "product_id": "<string>",
              "values": [
                {}
              ],
              "metadata": {},
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z"
            }
          ],
          "description": "<string>",
          "id": "<string>",
          "metadata": {},
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "handle": "<string>",
          "subtitle": "<string>",
          "is_giftcard": true,
          "thumbnail": "<string>",
          "width": 123,
          "weight": 123,
          "height": 123,
          "origin_country": "<string>",
          "hs_code": "<string>",
          "mid_code": "<string>",
          "material": "<string>",
          "collection_id": "<string>",
          "type_id": "<string>",
          "images": [
            {
              "id": "<string>",
              "url": "<string>",
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z",
              "metadata": {},
              "rank": 123
            }
          ],
          "discountable": true,
          "external_id": "<string>",
          "deleted_at": "2023-11-07T05:31:56Z",
          "shipping_profile": {
            "id": "<string>",
            "name": "<string>",
            "type": "<string>",
            "metadata": {},
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z",
            "deleted_at": "2023-11-07T05:31:56Z"
          }
        },
        "product_id": "<string>",
        "product_title": "<string>",
        "product_description": "<string>",
        "product_subtitle": "<string>",
        "product_type": "<string>",
        "product_collection": "<string>",
        "product_handle": "<string>",
        "variant_sku": "<string>",
        "variant_barcode": "<string>",
        "variant_title": "<string>",
        "variant_option_values": {
          "Color": "Blue"
        },
        "requires_shipping": true,
        "is_discountable": true,
        "is_tax_inclusive": true,
        "compare_at_unit_price": 123,
        "unit_price": 123,
        "quantity": 123,
        "tax_lines": [
          {
            "item": {},
            "item_id": "<string>",
            "total": 123,
            "subtotal": 123,
            "id": "<string>",
            "description": "<string>",
            "tax_rate_id": "<string>",
            "code": "<string>",
            "rate": 123,
            "provider_id": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "adjustments": [
          {
            "item": {},
            "item_id": "<string>",
            "id": "<string>",
            "code": "<string>",
            "amount": 123,
            "order_id": "<string>",
            "description": "<string>",
            "promotion_id": "<string>",
            "provider_id": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "detail": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "metadata": {},
        "original_total": 123,
        "original_subtotal": 123,
        "original_tax_total": 123,
        "item_total": 123,
        "item_subtotal": 123,
        "item_tax_total": 123,
        "total": 123,
        "subtotal": 123,
        "tax_total": 123,
        "discount_total": 123,
        "discount_tax_total": 123,
        "refundable_total": 123,
        "refundable_total_per_unit": 123,
        "product_type_id": "<string>"
      },
      "customer": {
        "id": "<string>",
        "has_account": true,
        "groups": [
          {
            "id": "<string>",
            "name": "<string>",
            "customers": [
              {}
            ],
            "metadata": {},
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "email": "jsmith@example.com",
        "default_billing_address_id": "<string>",
        "default_shipping_address_id": "<string>",
        "company_name": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "addresses": [
          {
            "id": "<string>",
            "address_name": "<string>",
            "is_default_shipping": true,
            "is_default_billing": true,
            "customer_id": "<string>",
            "company": "<string>",
            "first_name": "<string>",
            "last_name": "<string>",
            "address_1": "<string>",
            "address_2": "<string>",
            "city": "<string>",
            "country_code": "us",
            "province": "us-ca",
            "postal_code": "<string>",
            "phone": "<string>",
            "metadata": {},
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "phone": "<string>",
        "metadata": {},
        "created_by": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z"
      },
      "id": "<string>",
      "code": "<string>",
      "status": "pending",
      "value": 123,
      "currency_code": "usd",
      "customer_id": "<string>",
      "reference_id": "<string>",
      "note": "<string>",
      "reference": "<string>",
      "expires_at": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "estimate_count": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
id

The gift card's ID.

​
customer_id

Filter by a customer ID to retrieve their gift cards.

​
created_at
object

Filter by a gift card's creation date.

​
updated_at
object

Filter by a gift card's update date.

​
limit
number

Limit the number of items returned in the list.

​
offset
number

The number of items to skip when retrieving a list.

​
order
string

The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with -.

​
fields
string

Comma-separated fields that should be included in the returned data. If a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. Without prefix it will replace the entire default fields.

​
$and
$and · object[]

Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters.

​
$or
$or · object[]

Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters.

Response

OK

The paginated list of gift cards.

​
limit
number
required

The maximum number of gift cards to return.

​
offset
number
required

The number of gift cards to skip before retrieving the results.

​
count
number
required

The total number of gift cards available.

​
gift_cards
object[]
required

The list of gift cards.

​
estimate_count
number

The gift card's estimate count.