--- title: "List earning rule activities" method: GET path: "/v2/loyalties/earning-rules/{earningRuleId}/activities" tags: ["Earning Rules"] --- # List earning rule activities `GET /v2/loyalties/earning-rules/{earningRuleId}/activities` Documentation in progress This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact [Voucherify support](https://www.voucherify.io/contact-support) or your Technical Account Manager. Returns a cursor-paginated list of activities (audit trail) for a single earning rule. The same field cannot be used in both ascending and descending order at once. Default order is `-created_at`. ## Path parameters - `id` string, required ## Query parameters - `limit` integer - `order` union - 'created_at' | '-created_at' - string[] - `cursor` string - `filters` EarningRuleActivitiesListFilters — Filters for listing earning rule activities. - `junction` 'AND' | 'OR', nullable — How multiple field filters are combined. Can be `null`. - `id` object, nullable — Activity ID filter. Allowed conditions: `$is`, `$is_not` (single value), `$in`, `$not_in` (up to 100 values). Values must match `^laer_[a-f0-9]+$`. Can be `null`. - `conditions` object, required - `$is` union — Exactly matches the value (single value). - string - string[] - `$is_not` union — Does not match the value (single value). - string - string[] - `$in` union — Matches any of the values (up to 100). - string - string[] - `$not_in` union — Matches none of the values (up to 100). - string - string[] - `type` object, nullable — Activity type filter (enum type). Allowed conditions: `$is`, `$is_not` (single value), `$in`, `$not_in` (up to 10 values). Can be `null`. - `conditions` object, required - `$is` union — Exactly matches the value (single value). - 'vl.earning_rule.created' | 'vl.earning_rule.updated' | 'vl.earning_rule.deleted' | 'vl.earning_rule.activated' | 'vl.earning_rule.deactivated' | 'vl.earning_rule.drafted' | 'vl.earning_rule.assigned' | 'vl.earning_rule.unassigned' — Earning rule activity type. - EarningRuleActivityType[] - `$is_not` union — Does not match the value (single value). - 'vl.earning_rule.created' | 'vl.earning_rule.updated' | 'vl.earning_rule.deleted' | 'vl.earning_rule.activated' | 'vl.earning_rule.deactivated' | 'vl.earning_rule.drafted' | 'vl.earning_rule.assigned' | 'vl.earning_rule.unassigned' — Earning rule activity type. - EarningRuleActivityType[] - `$in` union — Matches any of the values (up to 10). - 'vl.earning_rule.created' | 'vl.earning_rule.updated' | 'vl.earning_rule.deleted' | 'vl.earning_rule.activated' | 'vl.earning_rule.deactivated' | 'vl.earning_rule.drafted' | 'vl.earning_rule.assigned' | 'vl.earning_rule.unassigned' — Earning rule activity type. - EarningRuleActivityType[] - `$not_in` union — Matches none of the values (up to 10). - 'vl.earning_rule.created' | 'vl.earning_rule.updated' | 'vl.earning_rule.deleted' | 'vl.earning_rule.activated' | 'vl.earning_rule.deactivated' | 'vl.earning_rule.drafted' | 'vl.earning_rule.assigned' | 'vl.earning_rule.unassigned' — Earning rule activity type. - EarningRuleActivityType[] - `created_at` EarningRuleDateFilterConditions — Date field filter conditions. `$before` and `$after` take a date string; `$is`, `$more_than` and `$less_than` take a non-negative integer number of days (relative comparison); `$has_value` and `$is_unknown` are presence checks. - `conditions` object, required - `$before` union — Before the given date (single date string). - string - string[] - `$after` union — After the given date (single date string). - string - string[] - `$is` union — Exactly N days ago (non-negative integer). - string - string[] - `$more_than` union — More than N days ago (non-negative integer). - string - string[] - `$less_than` union — Less than N days ago (non-negative integer). - string - string[] - `$has_value` string — Field has a value (presence check). - `$is_unknown` string — Field has no value (absence check). ## Response `200` Paginated list of earning rule activities - EarningRuleActivitiesListResponse — Cursor-paginated list of earning rule activities. - `data` EarningRuleActivityResponse[] — Activities on the current page. - `id` string — Activity ID (`laer_...`). - `earning_rule_id` string — ID of the earning rule the activity belongs to. - `type` 'vl.earning_rule.created' | 'vl.earning_rule.updated' | 'vl.earning_rule.deleted' | 'vl.earning_rule.activated' | 'vl.earning_rule.deactivated' | 'vl.earning_rule.drafted' | 'vl.earning_rule.assigned' | 'vl.earning_rule.unassigned' — Earning rule activity type. - `data` object — Activity payload. For created/updated/deleted/activated/deactivated/drafted activities it contains an `earning_rule` snapshot (the full earning rule object at the time of the change). - `created_at` string, date-time — Activity timestamp (ISO 8601). - `group_id` string — Groups related activities recorded together. - `source` EarningRuleActivitySource — Origin of the activity. - `channel` 'USER_PORTAL' | 'API' | 'CLIENT_API' | 'INTERNAL' — Channel through which the change was made. - `user` object — User who made the change (present for USER_PORTAL channel). - `id` string — User ID. - `api_key` object — API key used to make the change (present for API/CLIENT_API channels). - `name` string — API key name. - `app_id` string — Application ID of the API key. - `client_app_id` string — Client application ID (for CLIENT_API keys). - `cursor` object, nullable — Pagination cursor. `null` when there are no more results. - `next` string — Cursor ID to pass as the `cursor` query parameter (matches `^lcrsaer_[a-f0-9]+$`). - `expires_at` string, date-time — Cursor expiration timestamp. - `object` 'list' — 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.net/voucherifyio/apis/voucherify-loyalty-v2-api.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-loyalty-v2-api/revisions/69be73b5cff0/schema)