v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB

Card Definitions

List Card Definition Activities

<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 card definition (creation, updates, deletion, state transitions and program assignments). Returns 404 when the card definition does not exist.

get/v2/loyalties/card-definitions/{cardDefinitionId}/activities

Path parameters

idstring required

Unique card definition ID. Pattern: ^lcdef_[a-f0-9]+$.

Query parameters

limitinteger

Maximum number of activities to return. Minimum: 1, maximum: 100. Defaults to 10 when omitted.

'created_at' | '-created_at'

string[]

Sort order. A single field or an array of fields. Prefix with - for descending. Defaults to -created_at. The same field cannot be used in both ascending and descending direction at the same time.

cursorstring

Pagination cursor returned by a previous call in cursor.next. Pattern: ^lcrsacd_[a-f0-9]+$.

junction'AND' | 'OR' | 'null' nullable

Logical junction between field filters. Defaults to AND.

Filter conditions per field, e.g. filters[type][conditions][$is]=vl.card_definition.created.

Response

A paginated list of card definition activities.

object'list' required

Object type marker. Always list.