---
title: "Getexpirationwarnings"
method: GET
path: "/v2/giftcards/programs/{programId}/reports/expiration-warnings"
tags: ["Gift Cards"]
---

# Getexpirationwarnings

`GET /v2/giftcards/programs/{programId}/reports/expiration-warnings`

## Path parameters

- `programId` string, required

## Query parameters

- `cardId` string

## Headers

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

## Response `200`

Successful Response

- ExpirationWarningReportResponse
  - `reportId` string, required
  - `generatedAt` string, date-time, required
  - `warnings` ExpirationWarningResponse[], required
    - `cardId` string, required
    - `cardNumber` string, required
    - `customerEmail` string, nullable, required
    - `customerName` string, nullable, required
    - `daysUntilExpiry` integer, required
    - `warningLevel` string, required
    - `expiresAt` string, date-time, required
    - `balance` string, required
  - `count30d` integer, required
  - `count60d` integer, required
  - `count90d` integer, required

## 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)