---
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`

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/v2/loyalties/earning-rules/{earningRuleId}/activities`
- Auth: one of:
  - API key in header `X-App-Id` and API key in header `X-App-Token`
  - HTTP bearer

<Info>

<Badge color="gray">Documentation in progress</Badge>

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.

</Info>

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`.

## Query parameters

- `limit` union
  - number
  - string
- `order` union
  - 'created_at' | '-created_at'
  - string[]
- `cursor` string, nullable
- `filters` LoyaltiesEarningRulesActivitiesListRequestQuery: Request query schema for **GET** `/v2/loyalties/earning-rules/{earningRuleId}/activities`.
  - `junction` 'AND' | 'OR', nullable: Joins the field filters. Allowed values are `AND` and `OR`. Defaults to `AND`.
  - `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: Matches one value. A string or a one-element array. Format `laer_[a-f0-9]+`.
        - string
        - string[]
      - `$is_not` union: Excludes one value. A string or a one-element array. Format `laer_[a-f0-9]+`.
        - string
        - string[]
      - `$in` union: Matches any of the values. A string or an array of 1 to 100 values. Format `laer_[a-f0-9]+`.
        - string
        - string[]
      - `$not_in` union: Excludes any of the values. A string or an array of 1 to 100 values. Format `laer_[a-f0-9]+`.
        - 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: Matches one value. A string or a one-element array.
        - '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: Excludes one value. A string or a one-element array.
        - '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. A string or an array of 1 to 10 values.
        - '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: Excludes any of the values. A string or an array of 1 to 10 values.
        - '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: Matches dates before the given value. An ISO 8601 date-time, as a string or a one-element array.
        - string
        - string[]
      - `$after` union: Matches dates after the given value. An ISO 8601 date-time, as a string or a one-element array.
        - string
        - string[]
      - `$is` union: Matches a date exactly the given number of days ago. A non-negative integer, as a string or a one-element array.
        - string
        - string[]
      - `$more_than` union: Matches dates more than the given number of days ago. A non-negative integer, as a string or a one-element array.
        - string
        - string[]
      - `$less_than` union: Matches dates less than the given number of days ago. A non-negative integer, as a string or a one-element array.
        - string
        - string[]
      - `$has_value` string: Matches when the field is set. The condition value is ignored.
      - `$is_unknown` string: Matches when the field is not set. The condition value is ignored.

## Response `200`

Paginated list of earning rule activities

- V2LoyaltiesEarningRulesActivitiesListResponseBody: 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.
- `500`: Internal server error.

## Changes

- **2026-10-14** (v2) `ec801ade260d`: 1 breaking, 4 warning, 4 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - deleted the `path` request parameter `earningRuleId`
  - removed the optional property `cursor` from the response with the `200` status
  - removed the optional property `data` from the response with the `200` status
  - …5 more
- **2026-10-13** (v2) `f95b50556c93`: 4 breaking, 5 info
  - added the new path request parameter `earningRuleId`
  - `query` request parameter `order` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `filters`, the type changed from no type to `object`
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer`
  - …5 more
- **2026-10-13** (v2) `9905dfce1d1e`: 1 breaking, 4 warning, 4 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - deleted the `path` request parameter `earningRuleId`
  - removed the optional property `cursor` from the response with the `200` status
  - removed the optional property `data` from the response with the `200` status
  - …5 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/earning-rules/:earningRuleId/activities/get.md)

---

[API](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/revisions/e0d9f2d2532f?raw)