# Redemptions History
source: https://developer.mastercard.com/easy-savings-specials/documentation/use-cases/use-cases-3/index.md

## Overview {#overview}

The `GET/redemptions` endpoint enables the issuer to retrieve past unlock or redemption transactions on behalf of the SME business cardholder using a unique transaction identifier (`orderId`).

## Pre-requisites {#pre-requisites}

1. The SME business cardholder profile must be linked to valid BIN details in the system.
2. The issuer must provide a mechanism to request and display or share previously redeemed offers for SME business cardholders.

## User journey {#user-journey}

Diagram use-case-redem-history

## Workflow {#workflow}

**1. Request initiation.**

* An SME business cardholder or the issuer initiates a request using the unique `orderId`.

**2. Retrieve redemption details.**

* Mastercard verifies the request and returns the order details associated with the specified `orderId`.
* The issuer displays or shares these details with the SME business cardholder.
* The SME business cardholder uses the provided information to redeem the offer according to the redemption instructions.

## Use case examples {#use-case-examples}

### Retrieve lost voucher code {#retrieve-lost-voucher-code}

An SME business cardholder previously unlocked an offer but misplaced the voucher code required for redemption on the merchant's website. The issuer uses the `orderId` to retrieve the voucher code and associated redemption instructions. The issuer re-shares this information with the SME business cardholder to complete the redemption process.

### Customer support verification {#customer-support-verification}

An SME business cardholder submits a support request, claiming they redeemed an offer but did not receive the expected benefit. The support team uses the `orderId` to retrieve the redemption record. They verify the voucher code, its validity, and redemption instructions to troubleshoot the issue and assist the SME business cardholder effectively.

## Redemptions history endpoint {#redemptions-history-endpoint}

See the API structure:

API Reference: `GET /redemptions/{order_id}`

