---
title: "List gift cards"
method: GET
path: "/gift-vouchers"
---

# List gift cards

`GET /gift-vouchers`

## Request

- Base URL: `https://api.ecommerceapi.uk/v1`
- URL: `https://api.ecommerceapi.uk/v1/gift-vouchers`
- Auth: HTTP basic

Retrieves a list of gift cards with pagination.

## Query parameters

- `count` integer
- `offset` integer
- `fields` string

## Response `200`

A list of gift cards.

- GiftCard[]
  - `id` integer: Unique identifier for the gift card.
  - `code` string: The unique code of the gift card.
  - `amount` number, float: The value of the gift card.
  - `amountUsed` number, float: The amount of the gift card that has been used.

## Other responses

- `400`: Invalid request parameters.
- `401`: Unauthorized. Invalid or missing API key.
- `500`: Server error.

---

[API](https://skmtc.dev/ecommerceapi/apis/gift-cards.md) - [All operations](https://skmtc.dev/ecommerceapi/apis/gift-cards/llms.txt) - [OpenAPI document](https://skmtc.dev/ecommerceapi/apis/gift-cards/revisions/6d99960b7bd8?raw)