Get voucher by ID

GET /v1/public/vouchers/{id}

Returns one issued customer voucher belonging to the authenticated merchant.

Authorization

X-API-Key required

Parameters

Name	Location	Type	Required	Description
id	path	string	Yes	The issued voucher's MongoDB _id.

Request example

curl -X GET "https://api.remyrewards.co.uk/v1/public/vouchers/66c735e253f2836fbe941234" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

Responses

Status	Description
200	Issued voucher retrieved.
401	The API key is missing or invalid.
404	The requested integration resource was not found.

Success response example

{
  "success": true,
  "data": {
    "id": "66c735e253f2836fbe941234",
    "code": "GIFT-8HD42K",
    "title": "£25 Gift Voucher",
    "value": 25,
    "remainingValue": 25,
    "currency": "GBP",
    "status": "active",
    "allowPartialRedemption": true,
    "expiry": "2027-08-23T23:59:59.000Z",
    "recipient": {
      "name": "Alex Morgan",
      "email": "alex@example.com"
    },
    "redemptions": [],
    "createdAt": "2026-08-01T09:00:00.000Z",
    "updatedAt": "2026-08-01T09:00:00.000Z"
  }
}