Get a merchant voucher

Merchants

Description

Retrieve a single merchant voucher.

Authentication Required: User must be authenticated and have the 'merchant' feature flag.

Authorization: Merchant users can only view vouchers for their own merchant account.

Parameters

id integer path required

Voucher ID

Responses

200 Successful response

application/json

statusstring

Example: success

dataobject

Example:

{
  "status": "success",
  "data": {
    "id": 1,
    "merchant_id": 1,
    "code": "GLOBAL15",
    "valid_from": "2026-05-01",
    "valid_until": "2026-12-31",
    "usage_conditions": "15% off orders above 100 EUR. Cannot be combined with other offers.",
    "created_at": "2026-05-20T10:00:00Z",
    "updated_at": "2026-05-20T10:00:00Z"
  }
}

401 Authentication required

application/json

Example:

{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}

404 Voucher not found

application/json