> ## Documentation Index > Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt > Use this file to discover all available pages before exploring further. # List program 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 for a specific program. Supports filtering by activity id, type, and created_at. ## OpenAPI ````yaml /openapi/loyalties-v2.json get /v2/loyalties/programs/{id}/activities openapi: 3.1.0 info: title: Voucherify Loyalty v2 API version: 2.0.0 description: >- Complete API documentation for Voucherify Loyalty v2 system. Requires LOYALTY_V2 feature flag. servers: - url: https://api.voucherify.io description: Production security: - bearerAuth: [] X-App-Id: [] X-App-Token: [] tags: - name: Card Definitions description: >- CRUD operations, lifecycle management, and activity history for card definitions. Card definitions describe the configuration for loyalty cards, including code generation, points expiration, earning/spending limits, pending points, refunds, and balance settings. - name: Programs description: >- Loyalty program CRUD, lifecycle management, program-scoped resource assignments (card definitions, earning rules, rewards, tier structures), member management (create, list, get, activate, deactivate, delete), card operations (points adjustment, pending points, expiring points, transactions), reward purchases, and activity history. - name: Earning Rules description: >- Manage earning rules that define how customers earn points or receive incentives based on triggers (events, segments, custom events). Includes CRUD, lifecycle, and activity history. - name: Tier Structures description: >- CRUD operations, lifecycle management, and activity history for tier structures. Includes nested tier definitions (create, list, update, delete) within tier structures. Tier structures define the tiering model for loyalty programs — how members qualify for and move between tiers. - name: Incentives description: >- Manage incentive definitions (fixed points, proportional points, material, digital). Includes CRUD, lifecycle transitions, and activity history. - name: Rewards description: >- CRUD, lifecycle operations, and activity history for reward definitions. Rewards can be material (product/SKU) or digital (discount coupons, gift vouchers). - name: Examine description: Examines the earning of loyalty points for a loyalty program member. paths: /v2/loyalties/programs/{id}/activities: get: tags: - Programs - Programs summary: List program activities description: > ⚠️ **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 for a specific program. Supports filtering by activity id, type, and created_at. operationId: listProgramActivities parameters: - $ref: '#/components/parameters/ProgramId' - $ref: '#/components/parameters/ProgramActivitiesFilterId' - $ref: '#/components/parameters/ProgramActivitiesFilterType' - $ref: '#/components/parameters/ProgramActivitiesFilterCreatedAt' - $ref: '#/components/parameters/ProgramActivitiesFilterJunction' - $ref: '#/components/parameters/QueryLimit' - $ref: '#/components/parameters/ProgramActivitiesOrder' - $ref: '#/components/parameters/ProgramActivitiesCursor' responses: '200': description: Paginated list of program activities content: application/json: schema: $ref: '#/components/schemas/ProgramActivityListResponse' '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: parameters: ProgramId: name: id in: path required: true description: Unique program identifier schema: type: string pattern: ^lprg_[a-f0-9]+$ ProgramActivitiesFilterId: name: filters[id][conditions] in: query required: false description: >- Filter by activity id. Supports conditions `$is`, `$is_not`, `$in`, `$not_in`. schema: type: object ProgramActivitiesFilterType: name: filters[type][conditions] in: query required: false description: > Filter by activity type. Supports conditions `$is`, `$is_not`, `$in`, `$not_in`. Valid values: `vl.program.created`, `vl.program.updated`, `vl.program.deleted`, `vl.program.activated`, `vl.program.deactivated`, `vl.program.card_definition.assigned`, `vl.program.card_definition.unassigned`, `vl.program.earning_rule.assigned`, `vl.program.earning_rule.unassigned`, `vl.program.reward.assigned`, `vl.program.reward.unassigned`, `vl.program.tier_structure.assigned`, `vl.program.tier_structure.unassigned` schema: type: object ProgramActivitiesFilterCreatedAt: name: filters[created_at][conditions] in: query required: false description: Filter by activity creation date. schema: type: object ProgramActivitiesFilterJunction: name: filters[junction] in: query required: false description: Logical junction for combining activity filters schema: type: string enum: - AND - OR QueryLimit: name: limit in: query required: false description: Maximum number of results to return (1-100, default 10) schema: type: integer minimum: 1 maximum: 100 default: 10 ProgramActivitiesOrder: name: order in: query required: false description: Sort order for activities schema: oneOf: - type: string enum: - created_at - '-created_at' - type: array items: type: string enum: - created_at - '-created_at' ProgramActivitiesCursor: name: cursor in: query required: false description: Cursor for pagination (from previous response) schema: type: string pattern: ^lcrsapr_[a-f0-9]+$ schemas: ProgramActivityListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ProgramActivityDTO' cursor: oneOf: - $ref: '#/components/schemas/PaginationCursor' - type: 'null' object: type: string const: list ProgramActivityDTO: type: object description: Program activity DTO (VLProgramActivityDTO extends VLBaseActivityDTO) properties: id: type: string pattern: ^laprg_[a-f0-9]+$ description: Unique activity identifier type: $ref: '#/components/schemas/ProgramActivityType' data: type: object description: >- Activity payload (varies by type, typically contains the program DTO snapshot) properties: program: $ref: '#/components/schemas/ProgramResponse' created_at: type: string format: date-time description: Activity timestamp group_id: type: string description: Group identifier for correlated activities source: $ref: '#/components/schemas/ActivitySource' program_id: type: string pattern: ^lprg_[a-f0-9]+$ description: Program this activity belongs to PaginationCursor: type: object description: Cursor for fetching the next page of results. properties: next: type: string description: >- Cursor token to pass as the `cursor` query parameter for the next page. expires_at: type: string format: date-time description: ISO 8601 timestamp when this cursor expires. required: - next - expires_at ErrorResponse: type: object description: Standard error response. properties: code: type: integer description: HTTP status code. key: type: string description: Machine-readable error key. message: type: string description: Human-readable error message. details: type: string description: Additional error details. request_id: type: - string - 'null' description: Request identifier for tracing. resource_id: type: string description: Related resource identifier (when applicable). resource_type: type: string description: Related resource type (when applicable). required: - code - key - message ProgramActivityType: type: string enum: - vl.program.created - vl.program.updated - vl.program.deleted - vl.program.activated - vl.program.deactivated - vl.program.card_definition.assigned - vl.program.card_definition.unassigned - vl.program.earning_rule.assigned - vl.program.earning_rule.unassigned - vl.program.reward.assigned - vl.program.reward.unassigned - vl.program.tier_structure.assigned - vl.program.tier_structure.unassigned ProgramResponse: type: object description: Program DTO returned by toDTO() properties: id: type: string pattern: ^lprg_[a-f0-9]+$ description: Unique program identifier name: type: string description: Program name status: $ref: '#/components/schemas/ProgramStatus' start_date: type: - string - 'null' format: date-time description: Program start date end_date: type: - string - 'null' format: date-time description: Program end date metadata: $ref: '#/components/schemas/Metadata' created_at: type: string format: date-time description: Creation timestamp (ISO 8601) updated_at: type: - string - 'null' format: date-time description: Last update timestamp (ISO 8601) object: type: string const: program ActivitySource: type: object description: Source information for an activity. properties: channel: type: string enum: - USER_PORTAL - API - CLIENT_API - INTERNAL description: Channel through which the activity was triggered. user: type: object properties: id: type: string description: User identifier. api_key: type: object properties: name: type: string app_id: type: string client_app_id: type: string ProgramStatus: type: string enum: - DRAFT - ACTIVE - INACTIVE - DELETED Metadata: type: object description: Custom key-value metadata. additionalProperties: true responses: BadRequest: description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT X-App-Id: type: apiKey name: X-App-Id in: header X-App-Token: type: apiKey name: X-App-Token in: header ````