Redemption Look-up

Enables businesses to retrieve detailed redemption information for transactions processed through Online Ordering or Point-of-Sale (POS) channels. By providing order-level visibility into applied offers and discounts, this API supports accurate reconciliation across platforms, improves reporting and analytics, and ensures consistency in backend systems and on customer receipts.

Headers

Accept
Type: string
required

Advertises which content types the client is able to understand
Authorization
Type: string
required

Bearer token for admin authorization, who is making a call on behalf of the customer. Send the API key in the following format: "Authorization: Bearer BUSINESS_ADMIN_KEY_GOES_HERE".

Body

application/json

transaction_no
Type: integer
required

Receipt number or transaction number on the receipt

Responses

application/json

get/api2/dashboard/users/redemption

curl https://SERVER_NAME_GOES_HERE.punchh.com/api2/dashboard/users/redemption \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer BUSINESS_ADMIN_KEY_GOES_HERE' \
  --header 'Content-Type: application/json' \
  --data '{
  "transaction_no": 11111111111
}'

Show Schema

{
  "transaction_no": "11111111111",
  "discounts_applied": {
    "redemption_id": "REDEMPTION_ID_GOES_HERE",
    "discount_type": "subscription",
    "discount_id": 5,
    "discount_value": null,
    "discount_details": {
      "table": {
        "item_id": 1,
        "name": "New Subscription Plan",
        "image": "IMAGE_URL_GOES_HERE",
        "base_amount": null,
        "points": null,
        "prompt_text_short": "",
        "prompt_text_long": "",
        "description": "",
        "item_properties": null,
        "created_at": "2022-11-21T07:24:42Z",
        "meta_detail": "",
        "start_date_tz": "2025-08-25T15:13:02Z",
        "end_date_tz": "2025-10-04T18:29:59Z",
        "auto_select": null,
        "max_applicable_quantity": 9
      }
    }
  }
}