Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-263151,3912.3 MB
Benefits

List benefit activities

<Warning>

<Badge color="yellow">BETA endpoint</Badge>

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.

</Warning>

Returns a cursor-paginated list of activities recorded for the benefit (created, updated, deleted, activated, drafted). Returns 404 when the benefit does not exist. Supports filtering by activity id, type, and created_at, ordering by created_at (default -created_at), and cursor-based pagination.

get/v2/loyalties/benefits/{benefitId}/activities

Path parameters

idstring required

Unique benefit ID, prefixed with lben_.

Query parameters

{"stackTrail":"paths:/v2/loyalties/benefits/{benefitId}/activities:get:parameters:1:schema","oasType":"schema","type":"unknown"}

Maximum number of activities to return. An integer between 1 and 100. Defaults to 10 when omitted.

string[]
OR
'created_at' | '-created_at'

Ordering of the results. Defaults to -created_at. The same field cannot be used in both ascending and descending order at once.

{"stackTrail":"paths:/v2/loyalties/benefits/{benefitId}/activities:get:parameters:3:schema","oasType":"schema","type":"unknown"}

Pagination cursor returned in the cursor.next field of a previous response.

junction'AND' | 'OR'

How conditions of multiple fields are combined. Defaults to AND.

Field-specific filter conditions, e.g. filters[type][conditions][$is]=vl.benefit.created. Conditions of multiple fields are combined with the junction.

Response

Cursor-paginated list of benefit activities

objectstring required

Type of the object. Always list.