--- title: "List card activities" method: GET path: "/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/activities" tags: ["Programs"] --- # List card activities `GET /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/activities` ## Request - Base URL: `https://api.voucherify.io` - URL: `https://api.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/activities` - Auth: none required 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](https://www.voucherify.io/contact-support) or your Technical Account Manager. Returns a cursor-paginated list of activities recorded for the member's card (created, assigned, unassigned, code generation succeeded/failed). Results can be filtered by id, type and created_at. Returns 404 when the program, member or card does not exist. ## Path parameters - `programId` string, required - `memberId` string, required - `cardId` string, required ## Query parameters - `limit` unknown - `order` union - string[] - 'created_at' | '-created_at' - `cursor` unknown - `filters` CardActivityListFilters: Filters for the card activities list. - `junction` 'AND' | 'OR': How multiple field filters are combined. Defaults to `AND`. - `id` CardActivityIdFilter: ID filter conditions for card activity IDs. At least one condition is required. - `conditions` object, required - `$is` union: Value equals. Single value or an array with exactly one value. - string - string[] - `$is_not` union: Value does not equal. Single value or an array with exactly one value. - string - string[] - `$in` union: Value is one of. Single value or an array of 1-100 values. - string - string[] - `$not_in` union: Value is not one of. Single value or an array of 1-100 values. - string - string[] - `type` CardActivityTypeFilter: Enum filter conditions for card activity types. At least one condition is required. - `conditions` object, required - `$is` union: Value equals. Single value or an array with exactly one value. - 'vl.card.created' | 'vl.card.assigned' | 'vl.card.unassigned' | 'vl.card.code_generation.succeeded' | 'vl.card.code_generation.failed' - string[] - `$is_not` union: Value does not equal. Single value or an array with exactly one value. - 'vl.card.created' | 'vl.card.assigned' | 'vl.card.unassigned' | 'vl.card.code_generation.succeeded' | 'vl.card.code_generation.failed' - string[] - `$in` union: Value is one of. Single value or an array of 1-10 values. - 'vl.card.created' | 'vl.card.assigned' | 'vl.card.unassigned' | 'vl.card.code_generation.succeeded' | 'vl.card.code_generation.failed' - string[] - `$not_in` union: Value is not one of. Single value or an array of 1-10 values. - 'vl.card.created' | 'vl.card.assigned' | 'vl.card.unassigned' | 'vl.card.code_generation.succeeded' | 'vl.card.code_generation.failed' - string[] - `created_at` MemberDateFilter: Date filter conditions. `$before`/`$after` take date strings; `$is`, `$more_than`, `$less_than` take non-negative integers; `$has_value`/`$is_unknown` are presence checks. Each condition accepts a single value or an array with exactly one value. At least one condition is required. - `conditions` object, required - `$before` union: Date is before the given date. - string - string[] - `$after` union: Date is after the given date. - string - string[] - `$is` union: Date matches the given non-negative integer value. - string - string[] - `$more_than` union: More than the given non-negative integer value. - string - string[] - `$less_than` union: Less than the given non-negative integer value. - string - string[] - `$has_value` string: Field has a value (presence check). - `$is_unknown` string: Field has no value (absence check). ## Response `200` Cursor-paginated list of card activities. - CardActivityListResponse: Cursor-paginated list of card activities. - `data` CardActivity[], required: Card activities on the current page. - `id` string, required: Unique activity ID. - `card_id` string, required: ID of the card the activity relates to. - `type` 'vl.card.created' | 'vl.card.assigned' | 'vl.card.unassigned' | 'vl.card.code_generation.succeeded' | 'vl.card.code_generation.failed', required: Activity type. - `data` object, required: Activity payload - snapshots of the objects involved at the time of the activity. - `created_at` string, date-time, required: Timestamp when the activity was recorded (ISO 8601). - `group_id` string: ID grouping activities recorded within the same request. - `source` MemberActivitySource: Origin of an activity. - `channel` 'USER_PORTAL' | 'API' | 'CLIENT_API' | 'INTERNAL': Channel through which the activity was triggered. - `user` object: The dashboard user who triggered the activity. Omitted when not applicable. - `id` string: User ID. - `api_key` object: The API key used to trigger the activity. Omitted when not applicable. - `name` string: API key name. - `app_id` string: Application ID of the API key. - `client_app_id` string: Client application ID of the API key. - `cursor` MemberListCursor, required: Pagination cursor. - `next` string, required: Cursor value to pass as the `cursor` query parameter to fetch the next page. - `expires_at` string, date-time: Timestamp when the cursor expires. - `object` string, required: Object type marker, always `list`. ## Other responses - `400`: Validation error - request body or query parameters failed validation, or the operation is not allowed in the current resource state. - `404`: Resource not found. - `409`: Conflict - e.g. duplicate resource or invalid state transition. - `500`: Internal server error. --- [API](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/revisions/4982266e0494?raw)