List reward activities

curl --request GET \
  --url {protocol}://{host}/v2/loyalties/rewards/{rewardId}/activities \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "data": {
        "reward": {
          "id": "<string>",
          "name": "<string>",
          "validity_hours": {
            "daily": [
              {
                "days_of_week": [
                  3
                ],
                "start_time": "09:00",
                "end_time": "17:00"
              }
            ]
          },
          "refunds": {},
          "costs": [
            {
              "id": "<string>",
              "rules": {
                "logic": "<string>"
              },
              "spending": [
                {
                  "points": 123,
                  "card_definition_id": "<string>"
                }
              ]
            }
          ],
          "metadata": {},
          "created_at": "2023-11-07T05:31:56Z",
          "object": "<string>",
          "start_date": "2023-11-07T05:31:56Z",
          "end_date": "2023-11-07T05:31:56Z",
          "material": {
            "product": {
              "id": "<string>"
            },
            "sku": {
              "product_id": "<string>",
              "id": "<string>"
            }
          },
          "digital": {
            "discount_coupons": {
              "campaign_id": "<string>"
            },
            "gift_vouchers": {
              "campaign_id": "<string>",
              "balance": 123
            },
            "loyalty_card_points": {
              "points": 123,
              "card_definition_id": "<string>"
            }
          },
          "updated_at": "2023-11-07T05:31:56Z"
        },
        "program": {},
        "program_reward": {}
      },
      "created_at": "2023-11-07T05:31:56Z",
      "reward_id": "<string>",
      "group_id": "<string>",
      "source": {
        "user": {
          "id": "<string>"
        },
        "api_key": {
          "name": "<string>",
          "app_id": "<string>",
          "client_app_id": "<string>"
        }
      }
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

List reward activities

BETA endpoint

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

Returns a cursor-paginated list of activities recorded for the given reward (created, updated, deleted, assigned, unassigned, activated, deactivated, drafted). Returns 404 when the reward does not exist.

GET

loyalties

rewards

{rewardId}

activities

List reward activities

curl --request GET \
  --url {protocol}://{host}/v2/loyalties/rewards/{rewardId}/activities \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "data": {
        "reward": {
          "id": "<string>",
          "name": "<string>",
          "validity_hours": {
            "daily": [
              {
                "days_of_week": [
                  3
                ],
                "start_time": "09:00",
                "end_time": "17:00"
              }
            ]
          },
          "refunds": {},
          "costs": [
            {
              "id": "<string>",
              "rules": {
                "logic": "<string>"
              },
              "spending": [
                {
                  "points": 123,
                  "card_definition_id": "<string>"
                }
              ]
            }
          ],
          "metadata": {},
          "created_at": "2023-11-07T05:31:56Z",
          "object": "<string>",
          "start_date": "2023-11-07T05:31:56Z",
          "end_date": "2023-11-07T05:31:56Z",
          "material": {
            "product": {
              "id": "<string>"
            },
            "sku": {
              "product_id": "<string>",
              "id": "<string>"
            }
          },
          "digital": {
            "discount_coupons": {
              "campaign_id": "<string>"
            },
            "gift_vouchers": {
              "campaign_id": "<string>",
              "balance": 123
            },
            "loyalty_card_points": {
              "points": 123,
              "card_definition_id": "<string>"
            }
          },
          "updated_at": "2023-11-07T05:31:56Z"
        },
        "program": {},
        "program_reward": {}
      },
      "created_at": "2023-11-07T05:31:56Z",
      "reward_id": "<string>",
      "group_id": "<string>",
      "source": {
        "user": {
          "id": "<string>"
        },
        "api_key": {
          "name": "<string>",
          "app_id": "<string>",
          "client_app_id": "<string>"
        }
      }
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id

string

header

required

X-App-Token

string

header

required

Path Parameters

string

required

Unique reward identifier, prefixed with lrew_.

Pattern: ^lrew_[a-f0-9]+$

Query Parameters

limit

integer | null

default:10

Maximum number of activities to return. Must be between 1 and 100. Defaults to 10 when not provided.

Required range: 1 <= x <= 100

order

Field(s) to order results by. Prefix with - for descending order. Accepts a single value or an array of values. Defaults to -created_at. The same field cannot be used in both ascending and descending order at once.

Available options:

created_at,

-created_at

cursor

string | null

Pagination cursor returned in the cursor.next field of a previous response. Must match the pattern ^lcrsarew_[a-f0-9]+$.

Pattern: ^lcrsarew_[a-f0-9]+$

filters

object | null

Field-specific filter conditions, passed as a deep object, e.g. filters[type][conditions][$is]=vl.reward.created. See the RewardActivityListFilters schema for available fields and conditions. Filters for the reward activities list. Each field accepts an object with a required conditions property.

Show child attributes

Response

Cursor-paginated list of reward activities.

data

object[]

required

The activities on the current page.

Show child attributes

cursor

object | null

required

Pagination cursor, or null when there are no more results.

Show child attributes

object

string

required

Object type marker; always list.

Allowed value: "list"

Last modified on July 27, 2026

⌘I

Introduction

Endpoints

Events

List reward activities

Authorizations

Path Parameters

Query Parameters

Response