---
title: "Getgiftcards"
method: GET
path: "/v2/giftcards/programs/{programId}/cards"
tags: ["Gift Cards"]
---

# Getgiftcards

`GET /v2/giftcards/programs/{programId}/cards`

## Path parameters

- `programId` string, required

## Query parameters

- `merchant_id` string
- `status` 'pending' | 'active' | 'suspended' | 'expired' | 'voided' | 'depleted' — Gift card status enumeration.
- `positive_balance` boolean
- `cardId` string
- `q` string, nullable
- `page` integer
- `limit` integer
- `offset` integer, nullable

## Headers

- `X-Eposn-Customer-Token` string, nullable
- `X-Eposn-Merchant-Token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/loyalty/apis/loyaltydog.md) · [All operations](https://skmtc.net/loyalty/apis/loyaltydog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loyalty/loyaltydog/versions/42b7b22af2b6/schema)